# 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.