IupSubmenu
Definition: |
include pGUI.e
Ihandle ih = IupSubmenu(nullable_string title=NULL, Ihandln menu=NULL, string attributes="", dword_seq args={}) |
Description: |
Creates a menu item that, when selected, opens another menu.
title: String containing the text to be shown on the item. It can be NULL. It will set the TITLE attribute. menu: optional child menu identifier. For more information on the attributes and args parameters see IupSetAttributes. Returns: the identifier of the created element. |
pwa/p2js: | Supported, but see +x? markers on individual attributes and callbacks. |
See Also: | IupMenuItem, IupSeparator, IupMenu |
Notes: |
In Motif and GTK, the text font will be affected by the dialog font when the menu is mapped.
IupSubMenu (with an uppercase 'M') is a simple alias of IupSubmenu and behaves identically. Some examples can be seen in demo\pGUI\sample.exw |
Attributes: | |
IMAGE? |
[Windows and GTK Only] (non inheritable) Image name of the submenu image. In Windows, an item in a menu bar cannot have a check mark. Ignored if submenu in a menu bar. A recommended size would be 16x16 to fit the image in the menu item. In Windows, if larger than the check mark area it will be cropped. (since 3.0) |
KEY? |
(non inheritable) Underlines a key character in the submenu title. It is updated only when TITLE is updated. Deprecated, use the mnemonic support directly in the TITLE attribute. |
TITLE? |
(non inheritable) Submenu Text. The "&" character can be used to define a mnemonic, the next character will be used as key. Use "&&" to show the "&" character (instead of defining a mnemonic). |
WID? | (non inheritable) In Windows, returns the HMENU of the parent menu and it is actually created only when its child menu is mapped. |
also | ACTIVE?: also accepted. |
Callbacks: | |
HIGHLIGHT_CB | Action generated when the submenu is highlighted. |
also | MAP_CB, UNMAP_CB, DESTROY_CB: common callbacks are supported. |