GetButtonAtPosition Method

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

This component is available for use in the Microsoft Windows 2000, Windows XP, and Windows Server 2003 operating systems. It may be altered or unavailable in subsequent versions.

 

The GetButtonAtPosition method retrieves the number of the button at the specified coordinates without selecting or activating it.

[ iButton = ] MSWebDVD.GetButtonAtPosition(xPos, yPos)

Parameters

xPos

Specifies the x-coordinate of the mouse pointer as an Integer.

yPos

Specifies the y-coordinate of the mouse pointer as an Integer.

Return Value

Returns an integer value specifying the button, if any, at the specified position.

Remarks

This method returns zero if no button is present at the given coordinates. Use this method when implementing custom mouse handling after setting DisableAutoMouseProcessing to true.

See also

ActivateButton

ButtonsAvailable

CurrentButton

GetButtonRect

SelectAndActivateButton

SelectAtPosition