This document covers the following topics:
A submenu control is a part of a complex menu structure. When the end user chooses a menu item of type submenu, the submenu control is pulled down, containing a vertical list of menu items.
You create a submenu control in the dialog editor by creating a menu item with the MENU-ITEM-TYPE of MT-SUBMENU or MT-WINDOWMENU. In Natural code, a submenu control is embedded into a menu structure by assigning its HANDLE to the MENU-HANDLE attribute of a menu item.
An MT-WINDOWMENU submenu control is used for MDI frame and MDI child windows. The windowing system adds the currently existing MDI child windows dynamically to such a submenu control.
The PARENT of a submenu control may be a dialog or NULL-HANDLE. If a dialog is the PARENT, the submenu control is private to the dialog and is deleted when the dialog is closed. If a NULL-HANDLE is the PARENT, the submenu control is free and will be deleted when the application is closed. A free submenu control can be shared among several menu structures in several dialogs if the handles are defined in a global data area rather than in a local data area.
| Attribute Name | Query | Set/Modify | In Attr. Window |
|---|---|---|---|
| CLIENT-DATA | X | X/X | |
| CLIENT-HANDLE | X | X/X | |
| CLIENT-KEY | X | X/X | |
| CLIENT-VALUE | X | X/X | |
| FIRST-CHILD | X | -/- | |
| HELP-ID | X | X/X | |
| LAST-CHILD | X | -/- | |
| MENU-ITEM-OLE | X | X/X | |
| PARENT | X | X/- | |
| PREDECESSOR | X | -/- | |
| STYLE | X | X/- | |
| SUCCESSOR | X | -/- | |
| SUPPRESS-BEFORE-OPEN-EVENT | X | X/X | |
| TYPE | X | X/- | |
| VISIBLE | X | X/X |
Before Open Event (may be suppressed).