Tabbed dialogs offer transition effects as the user switches between tab pages. The new page to be activated can simply be displayed, or it can use a transition effect which "slides" or "rolls" the new page into place.

An application can define a default transition effect which applies to all tab pages using the SFTTABS_CONTROL, defaultAnimationStyleShow and defaultAnimationTimeShow members (see SetControlInfo).

Each tab page can override the default transition effect using the SFTTABS_TAB, animationStyleShow and animationTimeShow members (see SetTabInfo).

Transition effects cannot be defined using the SftTabs/DLL Wizard. These must be implemented at run-time using the sample code shown in the API section.

Windows Mobile Edition: Transition effects are not available. For source code compatibility, API functions for transition effects are available, but are ignored when used.

Example

This example defines a default transition effect for all tab pages of the current tab control:

C

SFTTABS_CONTROL Ctl;
SftTabs_GetControlInfo(hwndTab, &Ctl);
Ctl.defaultAnimationStyleShow = SFTTABS_EXPAND_CENTER;
Ctl.defaultAnimationTimeShow = 200;
SftTabs_SetControlInfo(hwndTab, &Ctl);

C++

SFTTABS_CONTROL Ctl;
m_Tab1.GetControlInfo(&Ctl);
Ctl.defaultAnimationStyleShow = SFTTABS_EXPAND_CENTER;
Ctl.defaultAnimationTimeShow = 200;
m_Tab1.SetControlInfo(&Ctl);

Example

This example defines a transition effect for just one z:

C

SFTTABS_TAB Tab;
SftTabs_GetTabInfo(hwndTab, 2, &Tab);
Tab.animationStyleShow = SFTTABS_SLIDE_FROM_LEFT;
Tab.animationTimeShow = 400;
SftTabs_SetTabInfo(hwndTab, 2, &Tab);

C++

SFTTABS_TAB Tab;
m_Tab.GetTabInfo(2, &Tab);
Tab.animationStyleShow = SFTTABS_SLIDE_FROM_LEFT;
Tab.animationTimeShow = 400;
m_Tab.SetTabInfo(2, &Tab);