The MENU widget can be used to create several kinds of menus. Each MENU item represents an application command or a submenu. Selecting a MENU item sends a WM_MENU message to the owner
of the MENU or opens a submenu. If mouse support is enabled, the MENU widget reacts on moving the mouse over the items of a MENU widget.
| MENU
|
 MENU with new skin. |
| Receives focus
|
Yes
|
| Skinnable
|
Yes
|
| OwnerDraw
|
No
|
| Uses Memory Devices
|
No
|
| Attached widgets
|
None
|
Notification codes
The MENU widget does not send any WM_NOTIFY_PARENT messages to the parent window.
Keyboard reaction
The BUTTON widget reacts to the following keys if it has the input focus:
| Message |
Description
|
| GUI_KEY_RIGHT
|
- If the MENU is horizontal, the selection moves one item to the right.
- If the MENU is vertical and the current item is a submenu, the submenu opens and the input focus moves to the submenu.
- If the MENU is vertical and the current item is not a submenu and the top level MENU is horizontal, the next item of the top level MENU opens and the input focus moves to it.
|
| GUI_KEY_LEFT
|
- If the MENU is horizontal the selection moves one item to the left.
- If the MENU is vertical and the MENU is not the top level MENU, the current MENU closes and the focus moves to the previous MENU. If the previous MENU is horizontal the previous submenu of it opens and the focus moves to the previous submenu.
|
| GUI_KEY_DOWN
|
- If the MENU is horizontal and the current MENU item is a submenu this submenu opens.
- If the MENU is vertical, the selection moves to the next item.
|
| GUI_KEY_UP
|
- If the MENU is vertical, the selection moves to the previous item.
|
| GUI_KEY_ESCAPE
|
- If the MENU is not the top level MENU the current MENU will be closed and the focus moves to the previous MENU.
- If the MENU is the top level MENU, the current MENU item becomes unselected.
|
| GUI_KEY_ENTER
|
- If the current MENU item is a submenu, the submenu opens and the focus moves to the submenu.
- If the current MENU item is not a submenu, all submenus of the top level MENU closes and a MENU_ON_ITEMSELECT message will be sent to the owner of the MENU.
|
