Usando controles Tree-View

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

Nesta secção

Tópico	Descrição
Como criar um Tree-View controle	Para criar um controle de exibição de árvore, use a funçãoCreateWindowEx, 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 de árvore pode ter duas imagens associadas a ele. Um item exibe uma imagem quando está selecionada 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 Tree-View	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 Tree-View	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, não verificados e marcados. Se seu aplicativo contiver mais de duas, essas funções precisarão ser modificadas para lidar com esse caso.
Como usar Tree-View Infotips	Quando aplica o estilo TVS_INFOTIP a um controlo de visualização em árvore, são geradas notificações TVN_GETINFOTIP quando o cursor está sobre um item na visualização em árvore. Ao responder a esta notificação, é possível definir o texto que aparece na dica de informação.