Adds a new tab to the end of a tab control.
Takes tabControl (Int), text (String), and name (String).
Returns the 0-based index of the newly added tab on success, -1 if tab control not found.
BGI GUI
Parameters & Returns
Parameters
tabControlInt
textString
nameString
Returns
Int
Quick Summary
Adds a new tab to the end of a tab control.
Takes tabControl (Int), text (String), and name (String).
Returns the 0-based index of the newly added tab on success, -1 if tab control not found.
Technical Exegesis...
Adds a new tab to the end of a tab control. Searches gizmoMap for the tabControl ID. Creates TCITEM structure with TCIF_TEXT mask and pszText pointing to text parameter. Gets current tab count with TabCtrl_GetItemCount to find insertion position (end). Inserts tab with TabCtrl_InsertItem at tabIndex position. Returns the 0-based index of the newly added tab on success, -1 if tab control not found.
This function appends a tab to the tab control. name parameter currently unused (reserved for future use).
Adds a new tab to the end of a tab control. Searches gizmoMap for the tabControl ID. Creates TCITEM structure with TCIF_TEXT mask and pszText pointing to text parameter. Gets current tab count with TabCtrl_GetItemCount to find insertion position (end). Inserts tab with TabCtrl_InsertItem at tabIndex position. Returns the 0-based index of the newly added tab on success, -1 if tab control not found.
This function appends a tab to the tab control. name parameter currently unused (reserved for future use). Tabs are added sequentially at the end. Returns index that can be used with other tab functions (bgiSetSelectedTab, bgiSetTabText, etc.). First tab added has index 0, second has index 1, etc. Use for building tab interfaces, multi-page dialogs, or document viewers. Tab text appears in the tab header.