Tab (Controles do Windows)
Esta seção contém informações sobre os elementos de programação usados com controles de guia.
Visão geral
| Tópico | Índice |
|---|---|
| Sobre os controles de guia | Um controle de tabulação é análogo aos divisores em um bloco de anotações ou às etiquetas em um gabinete de arquivos. Usando um controle de guia, um aplicativo pode definir várias páginas para a mesma área de uma janela ou caixa de diálogo. |
| Usando controles de guia | Este tópico contém dois exemplos que usam controles de guia. |
Macros
| Tópico | Índice |
|---|---|
| TabCtrl_AdjustRect | Calcula a área de exibição de um controle de tabulação dado um retângulo de janela ou calcula o retângulo de janela que corresponderia a uma área de exibição especificada. Você pode usar essa macro ou enviar a mensagem TCM_ADJUSTRECT explicitamente. |
| TabCtrl_DeleteAllItems | Remove todos os itens de um controle de guia. Você pode usar essa macro ou enviar a mensagem de TCM_DELETEALLITEMS explicitamente. |
| TabCtrl_DeleteItem | Remove um item de um controle de guia. Você pode usar essa macro ou enviar a mensagem de TCM_DELETEITEM explicitamente. |
| TabCtrl_DeselectAll | Redefine itens em um controle de guia, limpando todos os que foram definidos para o estado TCIS_BUTTONPRESSED. Você pode usar essa macro ou enviar a mensagem TCM_DESELECTALL explicitamente. |
| TabCtrl_GetCurFocus | Retorna o índice do item que tem o foco em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETCURFOCUS explicitamente. |
| TabCtrl_GetCurSel | Determina a guia atualmente selecionada em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETCURSEL explicitamente. |
| TabCtrl_GetExtendedStyle | Recupera os estilos estendidos que estão atualmente em uso para o controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETEXTENDEDSTYLE explicitamente. |
| TabCtrl_GetImageList | Recupera a lista de imagens associada a um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETIMAGELIST explicitamente. |
| TabCtrl_GetItem | Recupera informações sobre uma guia em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETITEM explicitamente. |
| TabCtrl_GetItemCount | Recupera o número de guias no controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETITEMCOUNT explicitamente. |
| TabCtrl_GetItemRect | Recupera o retângulo delimitador de uma guia em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETITEMRECT explicitamente. |
| TabCtrl_GetRowCount | Recupera o número atual de linhas de guias em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETROWCOUNT explicitamente. |
| TabCtrl_GetToolTips | Recupera o identificador para o controle de dica de ferramenta associado a um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_GETTOOLTIPS explicitamente. |
| TabCtrl_GetUnicodeFormat | Recupera o sinalizador de formato de caractere UNICODE para o controle. Você pode usar essa macro ou enviar a mensagem TCM_GETUNICODEFORMAT explicitamente. |
| TabCtrl_HighlightItem | Define o estado de realce de um item de tabulação. Você pode usar essa macro ou enviar a mensagem TCM_HIGHLIGHTITEM explicitamente. |
| TabCtrl_HitTest | Determina qual guia, se houver, está em uma posição de tela especificada. Você pode usar essa macro ou enviar a mensagem TCM_HITTEST explicitamente. |
| TabCtrl_InsertItem | Insere uma nova guia em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_INSERTITEM explicitamente. |
| TabCtrl_RemoveImage | Remove uma imagem da lista de imagens de um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_REMOVEIMAGE explicitamente. |
| TabCtrl_SetCurFocus | Define o foco para uma guia especificada em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETCURFOCUS explicitamente. |
| TabCtrl_SetCurSel | Seleciona uma guia em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETCURSEL explicitamente. |
| TabCtrl_SetExtendedStyle | Define os estilos estendidos que o controle tab usará. Você pode usar essa macro ou enviar a mensagem TCM_SETEXTENDEDSTYLE explicitamente. |
| TabCtrl_SetImageList | Atribui uma lista de imagens a um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETIMAGELIST explicitamente. |
| TabCtrl_SetItem | Define alguns ou todos os atributos de uma guia. Você pode usar essa macro ou enviar a mensagem TCM_SETITEM explicitamente. |
| TabCtrl_SetItemExtra | Define o número de bytes por guia reservados para dados definidos pelo aplicativo em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETITEMEXTRA explicitamente. |
| TabCtrl_SetItemSize | Define a largura e a altura das guias em um controle de tabulação de largura fixa ou desenhado pelo proprietário. Você pode usar essa macro ou enviar a mensagem TCM_SETITEMSIZE explicitamente. |
| TabCtrl_SetMinTabWidth | Define a largura mínima dos itens em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETMINTABWIDTH explicitamente. |
| TabCtrl_SetPadding | Define a quantidade de espaço (preenchimento) em torno do ícone e rótulo de cada guia em um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETPADDING explicitamente. |
| TabCtrl_SetToolTips | Atribui um controle de dica de ferramenta a um controle de guia. Você pode usar essa macro ou enviar a mensagem TCM_SETTOOLTIPS explicitamente. |
| TabCtrl_SetUnicodeFormat | Define o sinalizador de formato de caractere Unicode para o controle. Esta mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle. Você pode usar essa macro ou enviar a mensagem TCM_SETUNICODEFORMAT explicitamente. |
Mensagens
| Tópico | Índice |
|---|---|
| TCM_ADJUSTRECT | Calcula a área de exibição de um controle de tabulação dado um retângulo de janela ou calcula o retângulo de janela que corresponderia a uma área de exibição especificada. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_AdjustRect. |
| TCM_DELETEALLITEMS | Remove todos os itens de um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_DeleteAllItems. |
| TCM_DELETEITEM | Remove um item de um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_DeleteItem. |
| TCM_DESELECTALL | Redefine itens em um controle de guia, limpando todos os que foram definidos para o estado TCIS_BUTTONPRESSED. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_DeselectAll. |
| TCM_GETCURFOCUS | Retorna o índice do item que tem o foco em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetCurFocus. |
| TCM_GETCURSEL | Determina a guia atualmente selecionada em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetCurSel. |
| TCM_GETEXTENDEDSTYLE | Recupera os estilos estendidos que estão atualmente em uso para o controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetExtendedStyle. |
| TCM_GETIMAGELIST | Recupera a lista de imagens associada a um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetImageList. |
| TCM_GETITEM | Recupera informações sobre uma guia em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItem. |
| TCM_GETITEMCOUNT | Recupera o número de guias no controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItemCount. |
| TCM_GETITEMRECT | Recupera o retângulo delimitador de uma guia em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItemRect. |
| TCM_GETROWCOUNT | Recupera o número atual de linhas de guias em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetRowCount. |
| TCM_GETTOOLTIPS | Recupera o identificador para o controle de dica de ferramenta associado a um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetToolTips. |
| TCM_GETUNICODEFORMAT | Recupera o sinalizador de formato de caractere Unicode para o controle. Você pode enviar essa mensagem explicitamente ou usar a macro TabCtrl_GetUnicodeFormat. |
| TCM_HIGHLIGHTITEM | Define o estado de realce de um item de tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_HighlightItem. |
| TCM_HITTEST | Determina qual guia, se houver, está em uma posição de tela especificada. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_HitTest. |
| TCM_INSERTITEM | Insere uma nova guia em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_InsertItem. |
| TCM_REMOVEIMAGE | Remove uma imagem da lista de imagens de um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_RemoveImage. |
| TCM_SETCURFOCUS | Define o foco para uma guia especificada em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetCurFocus. |
| TCM_SETCURSEL | Seleciona uma guia em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetCurSel. |
| TCM_SETEXTENDEDSTYLE | Define os estilos estendidos que o controle tab usará. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetExtendedStyle. |
| TCM_SETIMAGELIST | Atribui uma lista de imagens a um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetImageList. |
| TCM_SETITEM | Define alguns ou todos os atributos de uma guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetItem. |
| TCM_SETITEMEXTRA | Define o número de bytes por guia reservados para dados definidos pelo aplicativo em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetItemExtra. |
| TCM_SETITEMSIZE | Define a largura e a altura das guias em um controle de tabulação de largura fixa ou desenhado pelo proprietário. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetItemSize. |
| TCM_SETMINTABWIDTH | Define a largura mínima dos itens em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetMinTabWidth. |
| TCM_SETPADDING | Define a quantidade de espaço (preenchimento) em torno do ícone e rótulo de cada guia em um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetPadding. |
| TCM_SETTOOLTIPS | Atribui um controle de dica de ferramenta a um controle de guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetToolTips. |
| TCM_SETUNICODEFORMAT | Define o sinalizador de formato de caractere Unicode para o controle. Esta mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle. Você pode enviar essa mensagem explicitamente ou usar a macro TabCtrl_SetUnicodeFormat. |
Notificações
| Tópico | Índice |
|---|---|
| NM_CLICK (separador) | Notifica a janela pai de um controle de guia que o usuário clicou no botão esquerdo do mouse dentro do controle. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_DBLCLK (separador) | Notifica uma janela pai de um controle de guia que o usuário clicou duas vezes no botão esquerdo do mouse dentro do controle. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_RCLICK (separador) | Notifica a janela pai de um controle de guia que o usuário clicou no botão direito do mouse dentro do controle. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_RDBLCLK (separador) | Notifica a janela pai de um controle de guia que o usuário clicou duas vezes no botão direito do mouse dentro do controle. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_RELEASEDCAPTURE (guia) | Notifica a janela pai de um controle de guia de que o controle está liberando a captura do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TCN_FOCUSCHANGE | Notifica a janela pai de um controle de guia de que o foco do botão foi alterado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TCN_GETOBJECT | Enviado por um controle de guia quando ele tem o estilo TCS_EX_REGISTERDROP estendido e um objeto é arrastado sobre um item de guia no controle. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TCN_KEYDOWN | Notifica a janela pai de um controle de tabulação de que uma tecla foi pressionada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TCN_SELCHANGE | Notifica a janela pai de um controle de guia de que a guia selecionada no momento foi alterada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TCN_SELCHANGING | Notifica a janela pai de um controle de guia de que a guia selecionada no momento está prestes a ser alterada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
Estruturas
| Tópico | Índice |
|---|---|
| NMTCKEYDOWN | Contém informações sobre um pressionamento de tecla em um controle de guia. Ele é usado com o código de notificação TCN_KEYDOWN. Esta estrutura substitui a estrutura TC_KEYDOWN. |
| TCHITTESTINFO | Contém informações sobre um teste de acerto. Esta estrutura substitui a estrutura TC_HITTESTINFO. |
| TCITEM | Especifica ou recebe os atributos de um item de guia. Ele é usado com as mensagens TCM_INSERTITEM, TCM_GETITEMe TCM_SETITEM. Esta estrutura substitui a estrutura TC_ITEM. |
| TCITEMHEADER | Especifica ou recebe os atributos de uma guia. Ele é usado com as mensagens TCM_INSERTITEM, TCM_GETITEMe TCM_SETITEM. Esta estrutura substitui a estrutura TC_ITEMHEADER. |
Constantes
| Tópico | Índice |
|---|---|
| Estilos estendidos de controle de tabulação | O controle tab agora oferece suporte a estilos estendidos. Esses estilos são manipulados usando as mensagens TCM_GETEXTENDEDSTYLE e TCM_SETEXTENDEDSTYLE e não devem ser confundidos com estilos de janela estendidos que são passados para CreateWindowEx. |
| Tab Control Item States | Os itens de controle de tabulação agora oferecem suporte a um estado de item para dar suporte à mensagem TCM_DESELECTALL. Além disso, a estrutura TCITEM oferece suporte a valores de estado de item. |
| Estilos de controle de guia | Esta seção lista os estilos de controle de guia suportados. |