Creates a toolbar control for icon buttons and separators.
Takes x (Int), y (Int), width (Int), height (Int), and parentWin (Int).
Returns gizmo ID on success, 0 if parent not found or creation failed.
BGI GUI
Parameters & Returns
Parameters
xInt
yInt
widthInt
heightInt
parentWinInt
Returns
Int
Quick Summary
Creates a toolbar control for icon buttons and separators.
Takes x (Int), y (Int), width (Int), height (Int), and parentWin (Int).
Returns gizmo ID on success, 0 if parent not found or creation failed.
Technical Exegesis...
Creates a toolbar control for displaying icon-based buttons. Searches gizmoMap for parent HWND. Handles scroll panels with GetActualParentHWND. Initializes common controls with ICC_BAR_CLASSES. Auto-increments gizmoIDCount. Creates toolbar with TOOLBARCLASSNAME using WS_CHILD | WS_VISIBLE | TBSTYLE_FLAT | TBSTYLE_TOOLTIPS style (flat appearance with tooltip support). Sends TB_BUTTONSTRUCTSIZE message with sizeof(TBBUTTON) - required for toolbar initialization.
Creates a toolbar control for displaying icon-based buttons. Searches gizmoMap for parent HWND. Handles scroll panels with GetActualParentHWND. Initializes common controls with ICC_BAR_CLASSES. Auto-increments gizmoIDCount. Creates toolbar with TOOLBARCLASSNAME using WS_CHILD | WS_VISIBLE | TBSTYLE_FLAT | TBSTYLE_TOOLTIPS style (flat appearance with tooltip support). Sends TB_BUTTONSTRUCTSIZE message with sizeof(TBBUTTON) - required for toolbar initialization. Creates CGizmo with GIZMO_TOOLBAR type, stores position, dimensions, state. Returns gizmo ID on success, 0 if parent not found or creation failed.
Toolbars provide icon-based button interfaces common in applications (like File/Edit menus with icons). Created without buttons initially - use bgiSetToolbarImageStrip to load button icons, then bgiAddToolbarButton to add individual buttons. TBSTYLE_FLAT creates modern flat appearance. TBSTYLE_TOOLTIPS enables hover tooltips (text parameter in bgiAddToolbarButton). Toolbar buttons send BGI_EVENT_COMMAND_CLICK events with buttonID for identification. Use for application toolbars, quick access buttons, or icon-based command interfaces.