Como criar um controle guia na janela principal
O exemplo nesta seção demonstra como criar um controle de guia e exibi-lo na área do cliente da janela principal do aplicativo. O aplicativo exibe uma terceira janela (um controle estático) na área de exibição do controle de guia. A janela pai posiciona e dimensiona o controle de tabulação e o controle estático quando processa a mensagem WM_SIZE.
Há sete guias neste exemplo, uma para cada dia da semana. Quando o usuário seleciona uma guia, o aplicativo exibe o nome do dia correspondente no controle estático.
O que você precisa saber
Tecnologias
Pré-requisitos
- C/C++
- Programação da interface do usuário do Windows
Instruções
Criar um controle de guia na janela principal
A função a seguir cria o controle de guia e adiciona uma guia para cada dia da semana. Os nomes dos dias são definidos como recursos de cadeia de caracteres, numerados consecutivamente começando com IDS_SUNDAY (definido no arquivo de cabeçalho de recurso do aplicativo). A janela pai e o controle de guia devem ter o estilo de janela WS_CLIPSIBLINGS. A função de inicialização do aplicativo chama essa função depois de criar a janela principal.
#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;
}
A função a seguir cria o controle estático que reside na área de exibição do controle de guia. A função de inicialização do aplicativo chama essa função depois de criar a janela principal e o controle de guia.
Observe que o controle estático está posicionado na área de exibição do controle de guia, mas ele é um irmão do controle de guia, não um filho. Isso permite que o controle estático participe da ordem de tabulação da janela pai compartilhada. Isso não é significativo para um controle estático, mas é uma boa prática caso ele seja substituído por um controle acessível pelo teclado como um botão.
// 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;
}
As funções de exemplo a seguir são chamadas a partir do procedimento de janela do aplicativo. O aplicativo chama a OnSize função ao processar a mensagem WM_SIZE para posicionar e dimensionar o controle de guia para se ajustar à área do cliente da janela principal.
Quando uma guia é selecionada, o controle de guia envia uma mensagem de WM_NOTIFY, especificando o código de notificação TCN_SELCHANGE. A função do OnNotify aplicativo processa esse código de notificação definindo o texto do controle estático.
// 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;
}
Tópicos relacionados