Creates a dropdown submenu on the menu bar.
Takes windowMenu (Int) and sText (String).
Returns the submenu ID on success, 0 if parent menu not found.
BGI GUI
Parameters & Returns
Parameters
windowMenuInt
sTextString
Returns
Int
Quick Summary
Creates a dropdown submenu on the menu bar.
Takes windowMenu (Int) and sText (String).
Returns the submenu ID on success, 0 if parent menu not found.
Technical Exegesis...
Creates a dropdown submenu (File, Edit, View, etc.) on a menu bar. Searches menuMap for the parent menu ID, then creates a new CMenu with CreatePopupMenu. Auto-increments menuIDCount. Sets menuType to MENU_TYPE_SUB, gizmoType to GIZMO_MENU. Stores the submenu text and parent ID. Calls AppendMenu with MF_STRING | MF_POPUP to add the dropdown to the parent menu bar. Returns the submenu ID on success, 0 if parent menu not found.
The submenu is a popup menu that appears when clicking the menu bar item.
Creates a dropdown submenu (File, Edit, View, etc.) on a menu bar. Searches menuMap for the parent menu ID, then creates a new CMenu with CreatePopupMenu. Auto-increments menuIDCount. Sets menuType to MENU_TYPE_SUB, gizmoType to GIZMO_MENU. Stores the submenu text and parent ID. Calls AppendMenu with MF_STRING | MF_POPUP to add the dropdown to the parent menu bar. Returns the submenu ID on success, 0 if parent menu not found.
The submenu is a popup menu that appears when clicking the menu bar item. Use bgiAppendSubMenuItem to add items (New, Open, Save, etc.) to this submenu. Use bgiAppendSubMenuSeperator to add visual separators between groups of items. The returned submenu ID is used for adding items.