SftTabs/DLL 6.5 - Tab Control

Destroy

The parent window of a tab control calls SftTabs_Destroy when the parent window is about to be destroyed.

C

BOOL WINAPI SftTabs_Destroy(HWND hwndParent, HWND hwndCtl);

Parameters

hwndParent

The window handle of the tab control's parent window.

hwndCtl

The window handle of the tab control.

Returns

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

Comments

The Destroy function is called by the parent window of a tab control when the parent window is about to be destroyed.

SftTabs_Destroy is only used in the C implementation of tabbed dialogs and tabbed windows.

The SftTabs_Destroy function ends and destroys all pages that may still exist (even though not active) by calling the tab callback routines SFTTABS_TABCALLBACK responsible for each tab page.

This C example shows a typical tabbed dialog WM_DESTROY message handler:

/* Unregister, or the window properties used won't be removed */
SftTabs_UnregisterDialog(hwndParent);

/* destroy all pages */
SftTabs_Destroy(hwndParent, GetDlgItem(hwndParent, IDC_TAB));

Examples

C

        }
        return FALSE;                   // input focus already set
     }

    case WM_DESTROY: {
        // Unregister, or the window properties used won't be removed
        SftTabs_UnregisterDialog(hwndDlg);
        // destroy all pages
        SftTabs_Destroy(hwndDlg, GetDlgItem(hwndDlg, IDC_P6_TAB1));
        SftTabs_Destroy(hwndDlg, GetDlgItem(hwndDlg, IDC_P6_TAB2));
        break;
     }

    case WM_COMMAND: {
        HWND hwndCtl = (HWND) lParam;
        int id = LOWORD(wParam);

View Entire Sample Code

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