Inserts a new tab at a specific index in a tab control.
Takes tabControl (Int), text (String), name (String), and index (Int).
Returns the index on success, -1 if tab control not found.
BGI GUI
Parameters & Returns
Parameters
tabControlInt
textString
nameString
indexInt
Returns
Int
Quick Summary
Inserts a new tab at a specific index in a tab control.
Takes tabControl (Int), text (String), name (String), and index (Int).
Returns the index on success, -1 if tab control not found.
Technical Exegesis...
Inserts a new tab at a specific index position in a tab control. Searches gizmoMap for the tabControl ID. Creates TCITEM structure with TCIF_TEXT mask and pszText pointing to text parameter. Inserts tab with TabCtrl_InsertItem at specified index position. Returns the index on success, -1 if tab control not found.
This function inserts a tab at any position (not just at end like bgiAddTab). name parameter currently unused (reserved for future use).
Inserts a new tab at a specific index position in a tab control. Searches gizmoMap for the tabControl ID. Creates TCITEM structure with TCIF_TEXT mask and pszText pointing to text parameter. Inserts tab with TabCtrl_InsertItem at specified index position. Returns the index on success, -1 if tab control not found.
This function inserts a tab at any position (not just at end like bgiAddTab). name parameter currently unused (reserved for future use). index is 0-based insertion position (0 = first position, 1 = second, etc.). Existing tabs at index and beyond shift right by one. To insert at end, use index >= tab count or use bgiAddTab. Use for inserting tabs in specific order, reorganizing tab structure, or context-sensitive tab additions.