SftTabs/DLL 6.5 - Tab Control

SetVersion

Sets the SftTabs/DLL version an application requires.

C

BOOL SftTabs_SetVersion(HWND hwndCtl, int version);

C++

BOOL CSftTabs::SetVersion(int version);

Parameters

hwndCtl

The window handle of the tab control.

version

A value indicating for which SftTabs/DLL version the application was developed:

Returns

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

Comments

The SetVersion function sets the SftTabs/DLL version an application requires.

When developing new applications, always use SetVersion(SFTTABS_6_5) to be compatible with SftTabs/DLL as documented in this reference.

If SetVersion is not used, compatibility with version 2.0 is the default.

SetVersion must be used for each tab control in an application.

Most features that were introduced with version 2.1 or 2.2 are available even if SetVersion(SFTTABS_2_0) is used. SetVersion cannot be used to disable new features. Its purpose is to make sure that certain API calls have the correct result. Certain features have been modified between 2.0 and 2.1 so the calls actually behave differently.

New behavior with SFTTABS_3_5, SFTTABS_4_0, SFTTABS_4_5, SFTTABS_5_0, SFTTABS_6_0, SFTTABS_6_5:

• Enables new features introduced in version 3.5, 4.0, 4.5, 5.0, 6.0 and 6.5 respectively.

New behavior with SFTTABS_2_1, SFTTABS_2_2:

• Enables new features introduced in version 2.1 or 2.2.
• If the tab control is resized, pages attached to the tab control are resized even if they are controlled via a frame window (see SftTabs_ActivatePage, SetControlInfo, CSftTabsDialog::InitializeTabControl or CSftTabsWindowSheet::InitializeTabControl for more information on frame windows).
• The SFTTABS_CONTROL structure members fToolTips, fDropText and fCondScrollButtons are honored.
• Ctrl+Tab and Ctrl+Shift+Tab select the next or previous tab.
• SftTabs_SetPageActive no longer removes the WS_TABSTOP style from an attached page.
• SftTabs_SetPageActive no longer copies a page's window caption to the enclosing window.

Example

This example sets version 6.5 compatibility:

C

SftTabs_SetVersion(hwndTab, SFTTABS_6_5);

C++

m_Tab.SetVersion(SFTTABS_6_5);

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