Compartilhar via


Como usar controles de exibição de árvore

Esta seção contém detalhes de implementação e código de exemplo para trabalhar com controles de exibição em árvore.

Nesta seção

Tópico Descrição
Como criar um controle de exibição em árvore
Para criar um controle de exibição em árvore, use a função CreateWindowEx, especificando o valor WC_TREEVIEW para a classe window. A classe de janela de exibição em árvore é registrada no espaço de endereço do aplicativo quando a DLL de controle comum é carregada. Para garantir que a DLL seja carregada, use a função InitCommonControls.
Como inicializar a lista de imagens
Cada item em um controle de exibição em árvore pode ter duas imagens associadas a ele. Um item exibe uma imagem quando é selecionado e a outra quando não está. Para incluir imagens com itens de exibição em árvore, primeiro use as funções Listas de Imagens para criar uma lista de imagens e adicionar imagens a ela. Em seguida, associe a lista de imagens ao controle de exibição em árvore usando a mensagem TVM_SETIMAGELIST.
Como adicionar itens de exibição em árvore
Você adiciona um item a um controle de exibição de árvore enviando a mensagem TVM_INSERTITEM para o controle. A mensagem inclui o endereço de uma estrutura TVINSERTSTRUCT, especificando o item pai, o item após o qual o novo item é inserido e uma estrutura TVITEM que define os atributos do item. Os atributos incluem o rótulo do item, suas imagens selecionadas e não selecionadas e um valor definido pelo aplicativo de 32 bits.
Como arrastar um item de exibição em árvore
Este tópico demonstra o código para lidar com arrastar e soltar itens de exibição em árvore. O código de exemplo consiste em três funções. A primeira função inicia a operação de arrastar, a segunda função arrasta a imagem e a terceira função termina a operação de arrastar.
Como trabalhar com índices de imagem de estado
Muitas vezes há confusão sobre como definir e recuperar o índice de imagem de estado em um controle de exibição em árvore. Os exemplos a seguir demonstram o método adequado para definir e recuperar o índice de imagem de estado. Os exemplos pressupõem que há apenas dois índices de imagem de estado no controle de exibição em árvore, desmarcados e verificados. Se o aplicativo contiver mais de dois, essas funções precisarão ser modificadas para lidar com esse caso.
Como usar as dicas de exibição em árvore
Quando você aplica o estilo TVS_INFOTIP a um controle de exibição em árvore, ele gera notificações TVN_GETINFOTIP quando o cursor está sobre um item no modo de exibição de árvore. Ao responder a essa notificação, você pode definir o texto que aparece na infodica.