Sets the display text for a specific tab by index.
Takes tabControl (Int), index (Int), and text (String).
Returns 1 if TabCtrl_SetItem succeeds, 0 if it fails or tab control not found.
BGI GUI
Parameters & Returns
Parameters
tabControlInt
indexInt
textString
Returns
Int
Quick Summary
Sets the display text for a specific tab by index.
Takes tabControl (Int), index (Int), and text (String).
Returns 1 if TabCtrl_SetItem succeeds, 0 if it fails or tab control not found.
Technical Exegesis...
Sets the display text for a specific tab in a tab control. Searches gizmoMap for the tabControl ID. Creates TCITEM structure with TCIF_TEXT mask and pszText pointing to text parameter. Calls TabCtrl_SetItem with index and structure. Returns 1 if TabCtrl_SetItem succeeds, 0 if it fails or tab control not found.
This function changes the text displayed in a tab header. index is 0-based position (0 = first tab, 1 = second tab, etc.).
Sets the display text for a specific tab in a tab control. Searches gizmoMap for the tabControl ID. Creates TCITEM structure with TCIF_TEXT mask and pszText pointing to text parameter. Calls TabCtrl_SetItem with index and structure. Returns 1 if TabCtrl_SetItem succeeds, 0 if it fails or tab control not found.
This function changes the text displayed in a tab header. index is 0-based position (0 = first tab, 1 = second tab, etc.). Use for updating tab labels dynamically, showing document names, or reflecting state changes (e.g., "Document*" for unsaved). Does not validate index explicitly - TabCtrl_SetItem returns failure for invalid indices. Text appears in the tab header strip.