Creates a list box for displaying selectable items.
Takes x (Int), y (Int), width (Int), height (Int), and parentWin (Int).
Returns gizmo ID on success, 0 if parent not found.
BGI GUI
Parameters & Returns
Parameters
xInt
yInt
widthInt
heightInt
parentWinInt
Returns
Int
Quick Summary
Creates a list box for displaying selectable items.
Takes x (Int), y (Int), width (Int), height (Int), and parentWin (Int).
Returns gizmo ID on success, 0 if parent not found.
Technical Exegesis...
Creates a list box control for displaying and selecting from a list of items. Searches gizmoMap for parent HWND. Handles scroll panels. Auto-increments gizmoIDCount. Creates using "LISTBOX" class with WS_CHILD | WS_VISIBLE | WS_BORDER | WS_VSCROLL | LBS_NOTIFY style (vertical scrollbar, sends selection notifications). Sets GUI font. Creates CGizmo with GIZMO_LISTBOX type, stores position, dimensions, state (visible=true, enabled=true). Returns gizmo ID on success, 0 if parent not found.
Creates a list box control for displaying and selecting from a list of items. Searches gizmoMap for parent HWND. Handles scroll panels. Auto-increments gizmoIDCount. Creates using "LISTBOX" class with WS_CHILD | WS_VISIBLE | WS_BORDER | WS_VSCROLL | LBS_NOTIFY style (vertical scrollbar, sends selection notifications). Sets GUI font. Creates CGizmo with GIZMO_LISTBOX type, stores position, dimensions, state (visible=true, enabled=true). Returns gizmo ID on success, 0 if parent not found.
List boxes display scrollable lists of text items. Use bgiAppendGizmoItem to add items. Use bgiGetSelectedGizmoItem to retrieve selected index. Use bgiSetSelectedGizmoItem to programmatically select an item. Generates BGI_EVENT_COMMAND_UPDATE when selection changes (LBN_SELCHANGE). Vertical scrollbar appears when items exceed visible height. Common for file lists, option selection, or data browsing. For dropdown lists, use bgiCreateComboBox instead.