Microsoft DirectX 9.0

Menus and Buttons

This topic applies to Windows XP Service Pack 1 only.

Menus are the full-page navigational splash screens designed by the DVD author that occur at the beginning of the DVD, and may appear elsewhere in the disc. Buttons are the selection items on the menu screens, rather than the buttons in the hosting form or Web page.

The MSVidWebDVD object automatically handles menu commands when the user clicks on the on-screen buttons with the mouse. An application does not need to do anything to implement basic mouse support. But an application can override this automatic mouse handling at any time in order to cause additional actions to take place when a user clicks on a menu button. For example, you could cause certain text or images to be displayed on a Web page depending on which button the user clicks. To implement custom mouse handling, use the MSVidWebDVD menu-related methods such as SelectAndActivateButton and ButtonAtPosition.

The MSVidWebDVD also offers a set of methods (for example, SelectUpperButton) which allow you to display an image map on your form representing a DVD remote control, with buttons that move the current button selection up, down, right and left. These buttons are referred to as "directional" or "relative" buttons in the documentation.

See Also