Guia (Controles do Windows)

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com controles de guia.

Visões gerais

Tópico Contents
Sobre controles de guia Um controle tab é análogo aos divisores em um notebook ou aos rótulos em um armário de arquivos. Usando um controle tab, 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 Contents
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 de TCM_ADJUSTRECT explicitamente.
TabCtrl_DeleteAllItems Remove todos os itens de um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_DELETEALLITEMS explicitamente.
TabCtrl_DeleteItem Remove um item de um controle 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 de 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 de TCM_GETCURFOCUS explicitamente.
TabCtrl_GetCurSel Determina a guia selecionada atualmente em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_GETCURSEL explicitamente.
TabCtrl_GetExtendedStyle Recupera os estilos estendidos que estão em uso para o controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_GETEXTENDEDSTYLE explicitamente.
TabCtrl_GetImageList Recupera a lista de imagens associada a um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_GETIMAGELIST explicitamente.
TabCtrl_GetItem Recupera informações sobre uma guia em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_GETITEM explicitamente.
TabCtrl_GetItemCount Recupera o número de guias no controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_GETITEMCOUNT explicitamente.
TabCtrl_GetItemRect Recupera o retângulo delimitador de ma guia em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_GETITEMRECT explicitamente.
TabCtrl_GetRowCount Recupera o número atual de linhas de guias em um controle 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 de 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 de TCM_GETUNICODEFORMAT explicitamente.
TabCtrl_HighlightItem Define o estado de realce de um item de guia. Você pode usar essa macro ou enviar a mensagem de TCM_HIGHLIGHTITEM explicitamente.
TabCtrl_HitTest Determina qual guia, se houver, está em uma posição especificada na tela. Você pode usar essa macro ou enviar a mensagem de TCM_HITTEST explicitamente.
TabCtrl_InsertItem Insere uma nova guia em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_INSERTITEM explicitamente.
TabCtrl_RemoveImage Remove uma imagem da lista de imagens de um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_REMOVEIMAGE explicitamente.
TabCtrl_SetCurFocus Define o foco para uma guia especificada em um controle guia. Você pode usar essa macro ou enviar a mensagem TCM_SETCURFOCUS explicitamente.
TabCtrl_SetCurSel Seleciona uma guia em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_SETCURSEL explicitamente.
TabCtrl_SetExtendedStyle Define os estilos estendidos que o controle de guia usará. Você pode usar essa macro ou enviar a mensagem de TCM_SETEXTENDEDSTYLE explicitamente.
TabCtrl_SetImageList Atribui uma lista de imagens a um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_SETIMAGELIST explicitamente.
TabCtrl_SetItem Define alguns ou todos os atributos de uma guia. Você pode usar essa macro ou enviar a mensagem de TCM_SETITEM explicitamente.
TabCtrl_SetItemExtra Define o número de bytes por guia reservado para dados definidos pelo aplicativo em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_SETITEMEXTRA explicitamente.
TabCtrl_SetItemSize Define a largura e a altura das guias em um controle de guia de largura fixa ou desenhado pelo proprietário. Você pode usar essa macro ou enviar a mensagem de TCM_SETITEMSIZE explicitamente.
TabCtrl_SetMinTabWidth Define a largura mínima dos itens em um controle guia. Você pode usar essa macro ou enviar a mensagem de TCM_SETMINTABWIDTH explicitamente.
TabCtrl_SetPadding Define a quantidade de espaço (preenchimento) em torno do ícone e do rótulo de cada guia em um controle guia. Você pode usar essa macro ou enviar a mensagem de 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 de TCM_SETTOOLTIPS explicitamente.
TabCtrl_SetUnicodeFormat Define o sinalizador de formato de caractere Unicode para o controle. Essa 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 de TCM_SETUNICODEFORMAT explicitamente.

Mensagens

Tópico Contents
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 guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_DeleteAllItems.
TCM_DELETEITEM Remove um item de um controle 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 selecionada atualmente em um controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetCurSel.
TCM_GETEXTENDEDSTYLE Recupera os estilos estendidos que estão em uso para o controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetExtendedStyle.
TCM_GETIMAGELIST Recupera a lista de imagens associada a um controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetImageList.
TCM_GETITEM Recupera informações sobre uma guia em um controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItem.
TCM_GETITEMCOUNT Recupera o número de guias no controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItemCount.
TCM_GETITEMRECT Recupera o retângulo delimitador de ma guia em um controle 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 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 guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_HighlightItem.
TCM_HITTEST Determina qual guia, se houver, está em uma posição especificada na tela. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_HitTest.
TCM_INSERTITEM Insere uma nova guia em um controle 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 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 guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetCurFocus.
TCM_SETCURSEL Seleciona uma guia em um controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetCurSel.
TCM_SETEXTENDEDSTYLE Define os estilos estendidos que o controle de guia usará. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetExtendedStyle.
TCM_SETIMAGELIST Atribui uma lista de imagens a um controle 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 reservado para dados definidos pelo aplicativo em um controle 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 guia 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 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 do rótulo de cada guia em um controle 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. Essa 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.

Notifications

Tópico Contents
NM_CLICK (guia) Notifica a janela pai de um controle de guia que o usuário clicou no botão esquerdo do mouse dentro do controle. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_DBLCLK (guia) 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 (guia) Notifica a janela pai de um controle de guia que o usuário clicou no botão direito do mouse dentro do controle. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_RDBLCLK (guia) 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_RELEASEDCAPTURE (guia) Notifica a janela pai de um controle de guia que o controle está liberando a captura do mouse. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TCN_FOCUSCHANGE Notifica a janela pai de um controle de guia de que o foco do botão foi alterado. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TCN_GETOBJECT Enviado por um controle de guia quando ele tem o TCS_EX_REGISTERDROP estilo estendido e um objeto é arrastado sobre um item de guia no controle. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TCN_KEYDOWN Notifica a janela pai de um controle de guia de que uma tecla foi pressionada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TCN_SELCHANGE Notifica a janela pai de um controle de guia de que a guia selecionada no momento foi alterada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TCN_SELCHANGING Notifica a janela pai de um controle de guia de que a guia selecionada no momento está prestes a mudar. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.

Estruturas

Tópico Contents
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. Essa estrutura substitui a estrutura TC_KEYDOWN .
TCHITTESTINFO Contém informações sobre um teste de acerto. Essa 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_GETITEM e TCM_SETITEM. Essa estrutura substitui a estrutura TC_ITEM .
TCITEMHEADER Especifica ou recebe os atributos de uma guia. Ele é usado com as mensagens TCM_INSERTITEM, TCM_GETITEM e TCM_SETITEM. Essa estrutura substitui a estrutura TC_ITEMHEADER .

Constantes

Tópico Contents
Estilos estendidos de controle de guia O controle de guia 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 estendida que são passados para CreateWindowEx.
Estados de item de controle de guia Os itens de controle de guia 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 com suporte.