Guia (Controles do Windows)
Esta seção contém informações sobre os elementos de programação usados com controles de guia.
Súmulas
| Tópico | Conteúdo |
|---|---|
| sobre controles tab | Um controle de tabulação é análogo aos divisores em um notebook ou aos rótulos em um armário de arquivos. Usando um controle de tabulação, um aplicativo pode definir várias páginas para a mesma área de uma janela ou caixa de diálogo. |
| usando controles de tabulação | Este tópico contém dois exemplos que usam controles de guia. |
Macros
| Tópico | Conteúdo |
|---|---|
| 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 da 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 tabulação. Você pode usar essa macro ou enviar a mensagem TCM_DELETEALLITEMS explicitamente. |
| TabCtrl_DeleteItem | Remove um item de um controle de tabulação. Você pode usar essa macro ou enviar a mensagem TCM_DELETEITEM explicitamente. |
| TabCtrl_DeselectAll | Redefine itens em um controle tab, desmarcando qualquer um que tenha sido definido como 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 tab. Você pode usar essa macro ou enviar a mensagem TCM_GETCURFOCUS explicitamente. |
| TabCtrl_GetCurSel | Determina a guia selecionada no momento em um controle de tabulação. Você pode usar essa macro ou enviar a mensagem TCM_GETCURSEL explicitamente. |
| TabCtrl_GetExtendedStyle | Recupera os estilos estendidos que estão sendo usados no momento para o controle tab. Você pode usar essa macro ou enviar a mensagem TCM_GETEXTENDEDSTYLE explicitamente. |
| TabCtrl_GetImageList | Recupera a lista de imagens associada a um controle de tabulação. Você pode usar essa macro ou enviar a mensagem TCM_GETIMAGELIST explicitamente. |
| TabCtrl_GetItem | Recupera informações sobre uma guia em um controle de tabulação. Você pode usar essa macro ou enviar a mensagem TCM_GETITEM explicitamente. |
| TabCtrl_GetItemCount | Recupera o número de guias no controle tab. Você pode usar essa macro ou enviar a mensagem TCM_GETITEMCOUNT explicitamente. |
| TabCtrl_GetItemRect | Recupera o retângulo delimitador para uma guia em um controle de tabulação. 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 tab. 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 tab. 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 guia. 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 tabulação. 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 tabulação. Você pode usar essa macro ou enviar a mensagem TCM_REMOVEIMAGE explicitamente. |
| TabCtrl_SetCurFocus | Define o foco como uma guia especificada em um controle tab. Você pode usar essa macro ou enviar a mensagem TCM_SETCURFOCUS explicitamente. |
| TabCtrl_SetCurSel | Seleciona uma guia em um controle de tabulação. 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 tabulação. 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 reservado para dados definidos pelo aplicativo em um controle tab. 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 guia 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 tab. 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 tabulação. Você pode usar essa macro ou enviar a mensagem TCM_SETPADDING explicitamente. |
| TabCtrl_SetToolTips | Atribui um controle de dica de ferramenta a um controle tab. 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. Essa mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução, em vez de precisar recriar o controle. Você pode usar essa macro ou enviar a mensagem TCM_SETUNICODEFORMAT explicitamente. |
Mensagens
| Tópico | Conteúdo |
|---|---|
| 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 da 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 tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_DeleteAllItems. |
| TCM_DELETEITEM | Remove um item de um controle de tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_DeleteItem. |
| TCM_DESELECTALL | Redefine itens em um controle tab, desmarcando qualquer um que tenha sido definido como 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 tab. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetCurFocus. |
| TCM_GETCURSEL | Determina a guia selecionada no momento em um controle de tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetCurSel. |
| TCM_GETEXTENDEDSTYLE | Recupera os estilos estendidos que estão sendo usados no momento para o controle tab. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetExtendedStyle. |
| TCM_GETIMAGELIST | Recupera a lista de imagens associada a um controle de tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetImageList. |
| TCM_GETITEM | Recupera informações sobre uma guia em um controle de tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItem. |
| TCM_GETITEMCOUNT | Recupera o número de guias no controle tab. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItemCount. |
| TCM_GETITEMRECT | Recupera o retângulo delimitador para uma guia em um controle de tabulação. 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 tab. 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 tab. 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 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 tabulação. 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 tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_RemoveImage. |
| TCM_SETCURFOCUS | Define o foco como uma guia especificada em um controle tab. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetCurFocus. |
| TCM_SETCURSEL | Seleciona uma guia em um controle de tabulação. 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 tabulação. 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 tab. 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 tab. 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 tabulação. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_SetPadding. |
| TCM_SETTOOLTIPS | Atribui um controle de dica de ferramenta a um controle tab. 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 precisar recriar o controle. Você pode enviar essa mensagem explicitamente ou usar a macro TabCtrl_SetUnicodeFormat. |
Notificações
| Tópico | Conteúdo |
|---|---|
| NM_CLICK (guia) | Notifica a janela pai de um controle de tabulação 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 tabulação que o usuário clicou duas vezes no botão esquerdo do mouse dentro do controle. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_RCLICK (guia) | Notifica a janela pai de um controle de tabulação 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 tabulação 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 tabulação de 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 tabulação 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 estilo estendido TCS_EX_REGISTERDROP 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 tabulação 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 tabulação de que a guia atualmente selecionada 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 tabulação de que a guia atualmente selecionada está prestes a ser alterada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
Estruturas
| Tópico | Conteúdo |
|---|---|
| NMTCKEYDOWN | Contém informações sobre uma tecla pressionada em um controle de tabulação. 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 ocorrência. 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_GETITEMe 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_GETITEMe TCM_SETITEM. Essa estrutura substitui a estrutura TC_ITEMHEADER. |
Constantes
| Tópico | Conteúdo |
|---|---|
| estilos estendidos de controle de guia | O controle de tabulação agora dá 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. |
| Estados do item de controle de guia | Os itens de controle de tabulação agora dão suporte a um estado de item para dar suporte à mensagem TCM_DESELECTALL. Além disso, a estruturaTCITEM dá suporte a valores de estado do item. |
| estilos de controle de guia | Esta seção lista os estilos de controle de guia com suporte. |