Creating a Tab Control
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
A controle guia é parecido com um conjunto de divisores em um bloco de anotações ou rótulos em um arquivo gabinete. Em um folha de propriedades, um usuário seleciona uma guia na ordem para mover de uma página em um folha de propriedades para outro. A seguinte ilustração mostra um controle guia Windows Embedded CE.
.gif)
Você envia mensagens para um controle guia para adicionar guias e para afetar a aparência e comportamento do controle. Cada mensagem possui um correspondente macro, que você pode usar instead of enviando a mensagem explicitamente. Embora você não pode desativar um individual guia em um controle guia, você pode desativar um controle guia em um folha de propriedades desativando o correspondente página.
Cada guia em um controle guia consiste em um rotular e dados Application-defined. Este dados são especificados por um TCITEM estrutura. Você pode adicionar guias a um controle guia, get o número de guias, recuperar e definir o conteúdo de uma guia e excluir tabulações. As guias são identificadas por suas índice com base zero.
Windows Embedded CE suporta um estendido estilo para o controle guia. Para definir um estendido estilo, você pode usar a mensagem TCM_SETEXTENDEDSTYLE ou seu correspondente macro, TabCtrl_SetExtendedStyle. Você pode usar a mensagem TCM_GETEXTENDEDSTYLE ou seu correspondente macro, TabCtrl_GetExtendedStyle, para recuperar o estendido estilo.
Observação
Porque um estendido estilo para um controle guia não é o mesmo que um estendido estilo janela, você não pode transmitir um estendido estilo para um controle guia para CreateWindowEx Quando você cria um controle guia.
O estendido estilo para o controle guia, conhecido como o estilo TCS_EX_FLATSEPARATORS, desenha um separador entre os itens guia controles guia que têm o estilo TCS_BUTTONS ou o estilo TCS_FLATBUTTONS. Quando você cria um controle guia que usa a TCS_BUTTONS ou o estilo TCS_FLATBUTTONS, o estendido estilo para o controle guia está definido Por padrão.
Para criar um controle guia
Especifica a classe WC_TABCONTROL in a Boolean parâmetro da CreateWindowEx função.
Windows Embedded CE registra esta classe quando ele carrega o DLL para a comum controle. Você pode usar o InitCommonControls função para garantir que este DLL é carregado. Para registrar a classe para o controle guia usando o InitCommonControlsEx função, especificar o sinalizador ICC_ TAB_CLASSES como o dwICC membro das INITCOMMONCONTROLSEX estrutura que você transmitir in a lpInitCtrls parâmetro.
Especificar um estilo para o controle guia na dwStyle parâmetro da CreateWindowEx função.
Você pode adicionar guias para o controle usando a mensagem TCM_INSERTITEM, que especifica a posição da guia e o endereço do seu TCITEM estrutura. Você pode recuperar e definir o conteúdo de uma existente guia usando as mensagens TCM_GETITEM e TCM_SETITEM. Para cada guia, você pode especificar um ícone, um rotular ou ambos.
Você pode associar Application-defined dados com cada guia. De exemplo, você pode salvar informações sobre cada página com seu correspondente guia. Por padrão, um controle guia aloca adicional quatro bytes por guia para dados Application-defined. Você pode alteração o número de adicional bytes por guia usando a mensagem TCM_SETITEMEXTRA. Você pode usar essa mensagem somente quando o controle guia é em branco.
O lParam membro das TCITEM estrutura Especifica dados Application-defined. Se você usar mais de quatro bytes de dados Application-defined, você precisará definir sua estrutura e usá-lo em vez de TCITEM. Você pode recuperar e definir dados Application-defined na mesma maneira que você recuperar e definir outras informações sobre uma guia, usando as mensagens TCM_GETITEM e TCM_SETITEM.
Observação
Windows Embedded CE faz não suporte texto vertical.Se você criar guias verticais e desejar usar texto vertical, você precisará criar um bitmap de texto e girá-la.Em seguida, você pode adicionar o bitmap para um lista de imagens e anexá-lo para a guia especificando o índice do bitmap na lista de imagens na iImage membro das TCITEM estrutura ou a TCITEMHEADER estrutura.
Você usa mensagens e estilos para saber sobre as guias. Você pode determinar o atual retângulo delimitador para uma guia usando a mensagem TCM_GETITEMRECT. Você pode determinar qual guia da caixa de diálogo, se houver algum, está em uma localidade especificada usando a mensagem TCM_HITTEST. Em um controle guia que usa o estilo TCS_MULTILINE, você pode determinar o atual número de linhas de guias usando a mensagem TCM_GETROWCOUNT.