MenuSelectEvent Class

Provide information about a MenuSelectEvent, generated whenever a menu item is highlighted on a menu (menu items are highlighted as the user moves either the mouse or the highlight bar up or down a menu).

Inheritance Hierarchy

Object
Event
MenuSelectEvent

Namespace: VO
Assembly: VOGUIClasses (in VOGUIClasses.dll) Version: 2.21

Syntax

Copy

 CLASS MenuSelectEvent INHERIT Event

public class MenuSelectEvent : Event

Request Example View Source

The MenuSelectEvent type exposes the following members.

Constructors

	Name	Description
	MenuSelectEvent	Initializes a new instance of the MenuSelectEvent class

Top

Properties

	Name	Description
	Handle	The pointer to the window where the event occurred (Inherited from Event.)
	HyperLabel	The hyperlabel connected to the menu that generated this MenuSelectEvent. From the hyperlabel, you can retrieve additional information about the menu.
	ItemID	A numeric value representing the ID of the menu item that generated this MenuSelectEvent.
	Menu	The Menu object that generated this MenuSelectEvent.
	Message	A dword representing the Windows API message associated with the given event. (Inherited from Event.)
	Name	A string representing the name stored in the hyperlabel of the menu items that generated this MenuSelectEvent.
	NameSym	A symbol representing the name stored in the hyperlabel of the menu items that generated this MenuSelectEvent.
	Window	An object indicating the window or control in which the event occurred. This is helpful, for example, for distinguishing between similar menu events coming from the same context menu attached to different controls. (Inherited from Event.)

Top

Methods

	Name	Description
	AsString	Return the caption of the selected menu item.

Top

Fields

	Name	Description
	hWnd	(Inherited from Event.)
	lParam	(Inherited from Event.)
	oWindow	(Inherited from Event.)
	uMsg	(Inherited from Event.)
	wParam	(Inherited from Event.)

Top

Remarks

MenuSelectEvent events enable the program to anticipate that the user can activate an item or to provide status information.

Tip
When a menu item is actually selected (and therefore executed), the system generates a MenuCommandEvent.

When an accelerator key is executed, a MenuSelectEvent, immediately followed by a MenuCommandEvent, is generated to simulate the mouse route—the various selections that you have to pass over to choose the option. (Thus, the accelerator generates the same event as those generated with a mouse.)

Examples

The following example prints a different help line in the status bar, depending on which command is currently selected:

Copy

 1CLASS MyWindow INHERIT TopAppWindow
 2METHOD MenuSelect(oMSE) CLASS MyWindow
 3LOCAL j := oMSE:ItemID
 4DO CASE
 5CASE j = IDMI_RED
 6TextPrint("Select the Red Pen", Point{10,10})
 7CASE j = IDMI_GREEN
 8TextPrint("Select the Green Pen", Point{10,10})
 9CASE j = IDMI_BLUE
10TextPrint("Select the Blue Pen", Point{10,10})
11ENDCASE

Reference

VO Namespace