Checks whether a checkable gizmo is currently checked.
Takes gizmo (Int).
Returns -1 if gizmo is not checkable (checkable == false).
BGI GUI
Parameters & Returns
Parameters
gizmoInt
Returns
Int
Quick Summary
Checks whether a checkable gizmo is currently checked.
Takes gizmo (Int).
Returns -1 if gizmo is not checkable (checkable == false).
Technical Exegesis...
Checks whether a checkable gizmo control is currently checked. Searches gizmoMap for the gizmo ID. Returns -1 if gizmo is not checkable (checkable == false). Calls IsDlgButtonChecked with parentHWND and gizmo ID. Returns 1 if state is BST_CHECKED, 0 if BST_UNCHECKED, -1 if gizmo not found or not checkable.
This function queries check state for checkboxes and radio buttons. Only works with checkable controls. Returns 1 (checked), 0 (unchecked), or -1 (not checkable/not found).
Checks whether a checkable gizmo control is currently checked. Searches gizmoMap for the gizmo ID. Returns -1 if gizmo is not checkable (checkable == false). Calls IsDlgButtonChecked with parentHWND and gizmo ID. Returns 1 if state is BST_CHECKED, 0 if BST_UNCHECKED, -1 if gizmo not found or not checkable.
This function queries check state for checkboxes and radio buttons. Only works with checkable controls. Returns 1 (checked), 0 (unchecked), or -1 (not checkable/not found). IsDlgButtonChecked retrieves current Windows state. Use for reading form values, validating selections, or conditional logic based on checkbox state. For radio button groups, use bgiGetGroupGizmoChecked to find which button is selected.