Inserts an item at a specific index in a list box or combo box.
Takes gizmo (Int), text (String), and index (Int).
Returns 1 or 0 if LB_ERR.
BGI GUI
Parameters & Returns
Parameters
gizmoInt
textString
indexInt
Returns
Int
Quick Summary
Inserts an item at a specific index in a list box or combo box.
Takes gizmo (Int), text (String), and index (Int).
Returns 1 or 0 if LB_ERR.
Technical Exegesis...
Inserts an item at a specific index position in a list box or combo box. Searches gizmoMap for the gizmo ID. For GIZMO_LISTBOX, sends LB_INSERTSTRING with index and text, returns 1 or 0 if LB_ERR. For GIZMO_COMBOBOX, sends CB_INSERTSTRING with index and text, returns 1 or 0 if LB_ERR (note: uses LB_ERR constant for CB check). Returns 0 if gizmo not found or unsupported gizmo type.
This function inserts an item at any position (not just at end like bgiAppendGizmoItem).
Inserts an item at a specific index position in a list box or combo box. Searches gizmoMap for the gizmo ID. For GIZMO_LISTBOX, sends LB_INSERTSTRING with index and text, returns 1 or 0 if LB_ERR. For GIZMO_COMBOBOX, sends CB_INSERTSTRING with index and text, returns 1 or 0 if LB_ERR (note: uses LB_ERR constant for CB check). Returns 0 if gizmo not found or unsupported gizmo type.
This function inserts an item at any position (not just at end like bgiAppendGizmoItem). index is 0-based insertion position (0 = first position, 1 = second, etc.). Existing items at index and beyond shift down by one. Works with both GIZMO_LISTBOX and GIZMO_COMBOBOX types. To insert at end, use index >= item count or use bgiAppendGizmoItem. Use for inserting items in specific order, maintaining sorted lists, or context-sensitive additions.