Creates a single-line text input box.
Takes text (String), 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
textString
xInt
yInt
widthInt
heightInt
parentWinInt
Returns
Int
Quick Summary
Creates a single-line text input box.
Takes text (String), 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 single-line text input control for user text entry. Searches gizmoMap for parent HWND. Handles scroll panels. Auto-increments gizmoIDCount. Creates using "EDIT" class with WS_CHILD | WS_VISIBLE | WS_BORDER | ES_AUTOHSCROLL style (auto-scrolls horizontally when text exceeds width). Sets GUI font. Sets initial text with WM_SETTEXT. Creates CGizmo with GIZMO_TEXTBOX type, stores text, position, dimensions, state (visible=true, enabled=true). Returns gizmo ID on success, 0 if parent not found.
Creates a single-line text input control for user text entry. Searches gizmoMap for parent HWND. Handles scroll panels. Auto-increments gizmoIDCount. Creates using "EDIT" class with WS_CHILD | WS_VISIBLE | WS_BORDER | ES_AUTOHSCROLL style (auto-scrolls horizontally when text exceeds width). Sets GUI font. Sets initial text with WM_SETTEXT. Creates CGizmo with GIZMO_TEXTBOX type, stores text, position, dimensions, state (visible=true, enabled=true). Returns gizmo ID on success, 0 if parent not found.
Textboxes allow single-line text input. Use bgiGetGizmoText to retrieve entered text. Use bgiSetGizmoText to programmatically set text. Generates BGI_EVENT_COMMAND_UPDATE when text changes (EN_CHANGE notification). Common for name fields, search boxes, or any single-line input. Press Enter in textbox does not close parent window. For multi-line input, use bgiCreateMultiLineTextbox.