Registers a window or a dialog containing a tab control. Once registered, SftTabs/DLL will perform special tabbed dialog handling, such as accelerator key handling, ESCAPE and TAB key processing, etc.

C

BOOL WINAPI SftTabs_RegisterDialog(HWND hwndDialog);
BOOL WINAPI SftTabs_RegisterWindow(HWND hwndWnd);

Parameters

hwndDialog, hwndWnd

The window handle of the window or dialog to be registered.

Returns

The return value is TRUE if the window is successfully registered with SftTabs/DLL.

Comments

The RegisterDialog function registers a window or a dialog containing a tab control. Once registered, SftTabs/DLL will perform special tabbed dialog handling, such as accelerator key handling, ESCAPE and TAB key processing, etc.

If this function is not called, certain features of SftTabs/DLL may not appear to be working correctly, such as accelerator keys, tab switching, ESCAPE key handling, etc.

A window or dialog registered using this function, must also be unregistered using SftTabs_UnregisterDialog or SftTabs_UnregisterWindow.

Example

This C example shows the end of a typical tabbed dialog WM_INITDIALOG message handler:

... additional initialization code ... 
index = SftTabs_AddTab(hwndTab, TEXT("&Six"));
SftTabs_SetTabInfo(hwndTab, index, &Tab5);
SftTabs_SetControlInfo(hwndTab, &CtlInit);
SftTabs_SetCurrentTab(hwndTab, 0);
// Make sure to turn redraw back on 
SendMessage(hwndTab, WM_SETREDRAW, (WPARAM)TRUE, 0); 
InvalidateRect(hwndTab, NULL, TRUE); 
// Activate current page.
SftTabs_ActivatePage(hwndParent, hwndTab, NULL, TRUE);
// Mark the window as a main, tabbed dialog (so accel. keys work) by registering it. 
// Register the dialog AFTER activating the current page
SftTabs_RegisterDialog(hwndParent); 
return FALSE; // WM_INITDIALOG, input focus already set

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