Erstellen eines Registerkartensteuerelements im Hauptfenster

Das Beispiel in diesem Abschnitt veranschaulicht, wie Sie ein Registersteuerelement erstellen und im Clientbereich des Hauptfensters der Anwendung anzeigen. Die Anwendung zeigt ein drittes Fenster (ein statisches Steuerelement) im Anzeigebereich des Registersteuerelements an. Das übergeordnete Fenster positioniert und passt die Größe des Registersteuerelements und des statischen Steuerelements an, wenn es die WM_SIZE-Nachricht verarbeitet.

In diesem Beispiel gibt es sieben Registerkarten, eine für jeden Wochentag. Wenn der Benutzer eine Registerkarte auswählt, zeigt die Anwendung den Namen des entsprechenden Tags im statischen Steuerelement an.

Wichtige Informationen

Technologie

• Windows-Steuerelemente

Voraussetzungen

• C/C++
• Programmierung einer Windows-Benutzeroberfläche

Anweisungen

Erstellen eines Registersteuerelements im Hauptfenster

Mit der folgenden Funktion wird das Registersteuerelement erstellt und für jeden Wochentag eine Registerkarte hinzugefügt. Die Namen der Tage werden als Zeichenkettenressourcen definiert, fortlaufend nummeriert beginnend mit IDS_SUNDAY (definiert in der Ressourcen-Headerdatei der Anwendung). Sowohl das übergeordnete Fenster als auch das Registersteuerelement müssen das WS_CLIPSIBLINGS Fensterformat aufweisen. Die Initialisierungsfunktion der Anwendung ruft diese Funktion nach dem Erstellen des Standard-Fensters auf.

#define DAYS_IN_WEEK 7

// Creates a tab control, sized to fit the specified parent window's client
//   area, and adds some tabs. 
// Returns the handle to the tab control. 
// hwndParent - parent window (the application's main window). 
// 
HWND DoCreateTabControl(HWND hwndParent) 
{ 
    RECT rcClient; 
    INITCOMMONCONTROLSEX icex;
    HWND hwndTab; 
    TCITEM tie; 
    int i; 
    TCHAR achTemp[256];  // Temporary buffer for strings.
 
    // Initialize common controls.
    icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
    icex.dwICC = ICC_TAB_CLASSES;
    InitCommonControlsEx(&icex);
    
    // Get the dimensions of the parent window's client area, and 
    // create a tab control child window of that size. Note that g_hInst
    // is the global instance handle.
    GetClientRect(hwndParent, &rcClient); 
    hwndTab = CreateWindow(WC_TABCONTROL, L"", 
        WS_CHILD | WS_CLIPSIBLINGS | WS_VISIBLE, 
        0, 0, rcClient.right, rcClient.bottom, 
        hwndParent, NULL, g_hInst, NULL); 
    if (hwndTab == NULL)
    { 
        return NULL; 
    }
 
    // Add tabs for each day of the week. 
    tie.mask = TCIF_TEXT | TCIF_IMAGE; 
    tie.iImage = -1; 
    tie.pszText = achTemp; 
 
    for (i = 0; i < DAYS_IN_WEEK; i++) 
    { 
        // Load the day string from the string resources. Note that
        // g_hInst is the global instance handle.
        LoadString(g_hInst, IDS_SUNDAY + i, 
                achTemp, sizeof(achTemp) / sizeof(achTemp[0])); 
        if (TabCtrl_InsertItem(hwndTab, i, &tie) == -1) 
        { 
            DestroyWindow(hwndTab); 
            return NULL; 
        } 
    } 
    return hwndTab; 
} 

Die folgende Funktion erstellt das statische Steuerelement, das sich im Anzeigebereich des Registersteuerelements befindet. Die Initialisierungsfunktion der Anwendung ruft diese Funktion nach dem Erstellen des Standard-Fensters und des Registersteuerelements auf.

Beachten Sie, dass das statische Steuerelement im Anzeigebereich des Registersteuerelements positioniert ist, aber selbst ein gleichgeordnetes Steuerelement des Registersteuerelements, kein untergeordnetes Element ist. Dadurch kann das statische Steuerelement an der Aktivierreihenfolge des freigegebenen übergeordneten Fensters teilnehmen. Dies ist für ein statisches Steuerelement nicht von Bedeutung, aber es empfiehlt sich, wenn es durch ein über die Tastatur zugängliches Steuerelement wie eine Schaltfläche ersetzt wird.

// Creates a child window (a static control) to occupy the tab control's 
//   display area. 
// Returns the handle to the static control. 
// hwndTab - handle of the tab control. 
// 
HWND DoCreateDisplayWindow(HWND hwndTab) 
{ 
    HWND hwndStatic = CreateWindow(WC_STATIC, L"", 
        WS_CHILD | WS_VISIBLE | WS_BORDER, 
        100, 100, 100, 100,        // Position and dimensions; example only.
        GetParent(hwndTab), NULL, g_hInst, // g_hInst is the global instance handle
        NULL); 
    return hwndStatic; 
}

Die folgenden Beispielfunktionen werden aus der Window-Prozedur der Anwendung aufgerufen. Die Anwendung ruft die Funktion beim Verarbeiten der OnSize WM_SIZE-Nachricht auf, um das Registersteuerelement so zu positionieren und zu skalieren, dass es in den Clientbereich des Standard-Fensters passt.

Wenn eine Registerkarte ausgewählt ist, sendet das Registersteuerelement eine WM_NOTIFY-Nachricht mit dem TCN_SELCHANGE-Benachrichtigungscode. Die OnNotify-Funktion der Anwendung verarbeitet diesen Benachrichtigungscode, indem der Text des statischen Steuerelements festgelegt wird.

// Handles the WM_SIZE message for the main window by resizing the 
//   tab control. 
// hwndTab - handle of the tab control.
// lParam - the lParam parameter of the WM_SIZE message.
//
HRESULT OnSize(HWND hwndTab, LPARAM lParam)
{
    RECT rc; 

    if (hwndTab == NULL)
        return E_INVALIDARG;

    // Resize the tab control to fit the client are of main window.
     if (!SetWindowPos(hwndTab, HWND_TOP, 0, 0, GET_X_LPARAM(lParam), GET_Y_LPARAM(lParam), SWP_SHOWWINDOW))
        return E_FAIL;

    return S_OK;
}

// Handles notifications from the tab control, as follows: 
//   TCN_SELCHANGING - always returns FALSE to allow the user to select a 
//     different tab.  
//   TCN_SELCHANGE - loads a string resource and displays it in a static 
//     control on the selected tab.
// hwndTab - handle of the tab control.
// hwndDisplay - handle of the static control. 
// lParam - the lParam parameter of the WM_NOTIFY message.
//
BOOL OnNotify(HWND hwndTab, HWND hwndDisplay, LPARAM lParam)
{
    TCHAR achTemp[256]; // temporary buffer for strings

    switch (((LPNMHDR)lParam)->code)
        {
            case TCN_SELCHANGING:
                {
                    // Return FALSE to allow the selection to change.
                    return FALSE;
                }

            case TCN_SELCHANGE:
                { 
                    int iPage = TabCtrl_GetCurSel(hwndTab); 

                    // Note that g_hInst is the global instance handle.
                    LoadString(g_hInst, IDS_SUNDAY + iPage, achTemp,
                        sizeof(achTemp) / sizeof(achTemp[0])); 
                    LRESULT result = SendMessage(hwndDisplay, WM_SETTEXT, 0,
                        (LPARAM) achTemp); 
                    break;
                } 
        }
        return TRUE;
}

Zugehörige Themen

Verwenden von Registersteuerelementen

Demo für allgemeine Windows-Steuerelemente (CppWindowsCommonControls)