Sets a tab's text.

C

BOOL SftTabs_SetTabLabel(HWND hwndCtl, int iTab, LPCTSTR lpsz);
BOOL SftTabs_SetTabLabel_A(HWND hwndCtl, int iTab, LPCSTR lpsz);
BOOL SftTabs_SetTabLabel_W(HWND hwndCtl, int iTab, LPCWSTR lpsz);

C++

BOOL CSftTabs::SetTabLabel(int iTab, LPCTSTR lpsz);

Parameters

hwndCtl

The window handle of the tab control.

iTab

The zero-based index of the tab for which the tab text is to be set.

lpsz

A pointer to a buffer containing the tab's text.

Returns

The return value is TRUE if the function was successful, otherwise FALSE is returned.

Comments

The SetTabLabel function sets a tab's text.

The tab control creates a copy of the string supplied.

A tab's text can be retrieved using GetTabLabel.

Example

This example sets the text of the second tab:

C

SftTabs_SetTabLabel(hwndTab, 1, "New Text"); 

C++

m_Tab.SetTabLabel(1, "New Text");

See Also  C/C++ API  |  C++ Classes  |  Notifications