IDvdControl2::SelectAtPosition

 
Microsoft DirectShow 9.0

IDvdControl2::SelectAtPosition

The SelectAtPosition method highlights the menu button under the mouse pointer position.

Syntax

  HRESULT SelectAtPosition(
  POINT point
);

Parameters

point

[in] Point on the screen, in screen pixel coordinates.

Return Values

Returns one of the following values.

Return code Description
S_OK Success.
VFW_E_DVD_NO_BUTTON No button is present at the mouse pointer position.
VFW_E_DVD_INVALIDDOMAIN The DVD Navigator is in the Stop domain.

Remarks

Note that angle and menu button indexes are one-based while audio stream and subpicture stream indexes are zero-based.

Call IDvdControl2::ActivateButton in response to a mouse click when the pointer is over a menu button.

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

This method is demonstrated in the DVDSample application in CDvdCore::OnMouseEvent.

Annex J Command Name Valid Domains
None DVD_DOMAIN_VideoManagerMenu
DVD_DOMAIN_VideoTitleSetMenu
DVD_DOMAIN_Title
DVD_DOMAIN_FirstPlay

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also