SftTabs/DLL 6.5 - Tab Control

SetCurrentTabEx

Makes the specified tab the new active tab.

C

int SftTabs_SetCurrentTabEx(HWND hwndCtl, int iTab);

C++

int CSftTabs::SetCurrentTabEx(int iTab);

Parameters

hwndCtl

The window handle of the tab control.

iTab

The zero-based index of the tab to be activated. All tabs can be deactivated by specifying -1 (based on the settings defined by SetAllowAllInactive).

Returns

The return value is the index of the new active tab, otherwise -1 is returned.

Comments

The SetCurrentTabEx function makes the specified tab the new active tab.

When using this function to activate a new tab, the normal tab switching mechanism takes place, such as calling the SFTTABS_TABCALLBACK tab callback function, the CSftTabsPage::AllowSwitch or CSftTabsWindowPage::AllowSwitch member functions of the C++ based implementation of tabbed dialog.

SetCurrentTab also changes the current tab, but only SetCurrentTabEx can be used to activate a disabled tab.

Example

This example makes the third tab the new active tab:

C

SftTabs_SetCurrentTabEx(hwndTab, 2);

C++

m_Tab.SetCurrentTabEx(2);

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