如何在主視窗中建立索引標籤控制件
本節中的範例示範如何建立索引卷標控件，並將其顯示在應用程式主視窗的工作區中。 應用程式會在索引標籤元件的顯示區域中顯示第三個視窗（靜態控件）。 父視窗會在處理 WM_SIZE 訊息時，定位控制項和靜態控制元件的位置和大小。
此範例中有七個索引標籤，一周中的每一天各有一個索引標籤。 當使用者選取索引標籤時，應用程式會在靜態控件中顯示對應日期的名稱。
您需要瞭解的資訊
技術
必要條件
- C/C++
- Windows 使用者介面程序設計
指示
在主視窗中建立索引標籤控制件
下列函式會建立索引標籤，併為一周的每一天新增索引標籤。 天數的名稱定義為字串資源，從IDS_SUNDAY開始連續編號（定義在應用程式的資源頭檔中）。 父視窗和索引標籤機控件都必須具有 WS_CLIPSIBLINGS 視窗樣式。 應用程式初始化函式會在建立主視窗之後呼叫此函式。
#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;
}
下列函式會建立位於索引標籤顯示區域中的靜態控件。 應用程式初始化函式會在建立主視窗和索引標籤之後呼叫此函式。
請注意，靜態控件位於選項卡控件的顯示區域中，但它本身是索引卷標控件的同層級，而不是子控件。 這可讓靜態控件參與共用父視窗的定位順序。 對於靜態控件而言，這並不重要，但如果它取代為鍵盤可存取的控件，例如按鈕，這是很好的作法。
// 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;
}
下列範例函式會從應用程式的視窗程式呼叫。 應用程式會在處理WM_SIZE訊息時呼叫 OnSize 函式，以定位及調整索引標籤控件的大小，以符合主視窗的工作區。
選取索引標籤時，索引標籤控件會傳送 WM_NOTIFY 訊息，並 指定TCN_SELCHANGE 通知碼。 應用程式的函 OnNotify 式會藉由設定靜態控件的文字來處理此通知程序代碼。
// 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;
}
相關主題