Compartilhar via


Tree-View controlar estilos estendidos

Esta seção lista os estilos estendidos usados ao criar controles de exibição de árvore. O valor de estilos estendidos é uma combinação bit a bit desses estilos.

Constante Descrição
TVS_EX_AUTOHSCROLL
Windows Vista. Remova a barra de rolagem horizontal e a rolagem automática, dependendo da posição do mouse.
TVS_EX_DIMMEDCHECKBOXES
Windows Vista. Adiciona uma caixa de seleção no lado mais à esquerda de um determinado item que contém um ícone de uma marca de marcar esmaecida, que pode indicar que um nó está selecionado porque seu pai está selecionado. Isso inclui um estado de caixa de seleção esmaecido, além de dois estados normais de caixa de seleção. Não o use ao mesmo tempo que o estilo de TVS_CHECKBOXES . Veja a observação abaixo.
TVS_EX_DOUBLEBUFFER
Windows Vista. Especifica como a tela de fundo é apagada ou preenchida.
TVS_EX_DRAWIMAGEASYNC
Windows Vista. Recupera informações da grade do calendário.
TVS_EX_EXCLUSIONCHECKBOXES
Windows Vista. Adiciona um ícone de caixa de seleção no lado mais à esquerda de um determinado item que contém um X vermelho. Isso inclui um estado de caixa de seleção de exclusão, além de dois estados normais de caixa de seleção. Não o use ao mesmo tempo que o estilo de TVS_CHECKBOXES . Veja a observação abaixo.
TVS_EX_FADEINOUTEXPANDOS
Windows Vista. Esmaeça os botões expando para dentro ou para fora quando o mouse se move para fora ou para um estado de focalização sobre o controle.
TVS_EX_MULTISELECT
Sem suporte. Não use.
TVS_EX_NOINDENTSTATE
Windows Vista. Não recuar o modo de exibição de árvore para os botões expando.
TVS_EX_NOSINGLECOLLAPSE
Windows Vista. Destinado ao uso interno; não recomendado para uso em aplicativos. Não recolha o item de exibição de árvore selecionado anteriormente, a menos que ele tenha o mesmo pai que a nova seleção. Esse estilo deve ser usado com o estilo TVS_SINGLEEXPAND .
Nota: Esse estilo pode não ter suporte em versões futuras do Comctl32.dll. Além disso, esse estilo não é definido em commctrl.h. Adicione a seguinte definição aos arquivos de origem do aplicativo para usar esse estilo: #define TVS_EX_NOSINGLECOLLAPSE 0x0001
TVS_EX_PARTIALCHECKBOXES
Windows Vista. Adiciona um ícone de caixa de seleção no lado mais à esquerda de um determinado item com um quadrado no centro, que pode indicar que o nó está parcialmente selecionado. Isso inclui um estado de caixa de seleção parcial, além de dois estados de caixa de seleção normais. Não o use ao mesmo tempo que o estilo de TVS_CHECKBOXES . Veja a observação abaixo.
TVS_EX_RICHTOOLTIP
Windows Vista. Permitir dicas de ferramenta avançadas no modo de exibição de árvore (personalizado desenhado com ícone e texto).

Observação sobre como usar estilos de caixa de seleção estendidos

O controle de exibição de árvore tem um comportamento muito específico para os estilos de caixa de seleção. Quando um estilo específico ou uma combinação de estilo 'EX' é ativado, o controle o mantém até o fim de sua vida útil (o que significa que você não pode modificar o primeiro estilo de caixa de seleção durante a vida útil do controle de exibição de árvore).

Para criar um controle de exibição de árvore com quaisquer estilos de caixa de seleção estendidos, você deve inicialmente criar a janela de controle sem o estilo de TVS_CHECKBOXES e adicionar (após a criação) o estilo de caixa de seleção estendido escolhido enviando a mensagem TVM_SETEXTENDEDSTYLE ou usando a macro TreeView_SetExtendedStyle . O estilo da caixa de seleção estendida pode ser qualquer combinação OR de estilo TVS_EX_DIMMEDCHECKBOXES, TVS_EX_EXCLUSIONCHECKBOXES ou TVS_EX_PARTIALCHECKBOXES .

O novo controle de exibição de árvore fornecerá os dois estados normais da caixa de seleção (marcados e desmarcados) mais 1 a 3 estados adicionais (função do estilo estendido escolhido). Os estados normais são sempre codificados como 0x1000 e 0x2000, e todos os estados adicionais são codificados com os próximos valores (0x3000, 0x4000 0x5000). Use TVIS_STATEIMAGEMASK constante (0xF000) como máscara para obter ou definir esses estados de/para a estrutura TVITEM .

Requisitos

Requisito Valor
parâmetro
CommCtrl.h