Contents Up Previous Next

wxMenuEvent

This class is used for a variety of menu-related events. Note that these do not include menu command events, which are handled using wxCommandEvent objects.

The default handler for wxEVT_MENU_HIGHLIGHT displays help text in the first field of the status bar.

Derived from

wxEvent
wxObject

Include files

<wx/event.h>

Event table macros

To process a menu event, use these event handler macros to direct input to member functions that take a wxMenuEvent argument. They can only be processed by a menubar's frame.

EVT_MENU_OPEN(func) A menu is about to be opened. On Windows, this is only sent once for each navigation of the menubar (up until all menus have closed).
EVT_MENU_CLOSE(func) A menu has been just closed.
EVT_MENU_HIGHLIGHT(id, func) The menu item with the specified id has been highlighted: used to show help prompts in the status bar by wxFrame
EVT_MENU_HIGHLIGHT_ALL(func) A menu item has been highlighted, i.e. the currently selected menu item has changed.

See also

Command events,
Event handling overview

Members

wxMenuEvent::wxMenuEvent
wxMenuEvent::GetMenu
wxMenuEvent::GetMenuId
wxMenuEvent::IsPopup


wxMenuEvent::wxMenuEvent

wxMenuEvent(WXTYPE id = 0, int id = 0, wxMenu* menu = NULL)

Constructor.


wxMenuEvent::GetMenu

wxMenu * GetMenu() const

Returns the menu which is being opened or closed. This method should only be used with the OPEN and CLOSE events and even for them the returned pointer may be NULL in some ports.


wxMenuEvent::GetMenuId

int GetMenuId() const

Returns the menu identifier associated with the event. This method should be only used with the HIGHLIGHT events.


wxMenuEvent::IsPopup

bool IsPopup() const

Returns true if the menu which is being opened or closed is a popup menu, false if it is a normal one.

This method should only be used with the OPEN and CLOSE events.