Modo de Exibição de Árvore
Esta seção contém informações sobre os elementos de programação usados com controles de exibição de árvore.
Súmulas
| Tópico | Conteúdo |
|---|---|
| sobre controles de Tree-View | Um controle de exibição de árvore é uma janela que exibe uma lista hierárquica de itens, como os títulos em um documento, as entradas em um índice ou os arquivos e diretórios em um disco. |
| 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 de árvore. |
Macros
| Tópico | Conteúdo |
|---|---|
| TreeView_CreateDragImage | Cria um bitmap arrastando para o item especificado em um controle de exibição de árvore. A macro também cria uma lista de imagens para o bitmap e adiciona o bitmap à lista de imagens. Um aplicativo pode exibir a imagem ao arrastar o item usando as funções de lista de imagens. Você pode usar essa macro ou enviar a mensagem TVM_CREATEDRAGIMAGE explicitamente. |
| TreeView_DeleteAllItems | Exclui todos os itens de um controle de exibição de árvore. |
| TreeView_DeleteItem | Remove um item e todos os seus descendentes de um controle de exibição de árvore. Você também pode enviar a mensagem TVM_DELETEITEM explicitamente. |
| TreeView_EditLabel | Inicia a edição in-loco do texto do item especificado, substituindo o texto do item por um controle de edição de linha única que contém o texto. Essa macro seleciona implicitamente e concentra o item especificado. Você pode usar essa macro ou enviar a mensagem TVM_EDITLABEL explicitamente. |
| TreeView_EndEditLabelNow | Encerra a edição do rótulo de um item de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_ENDEDITLABELNOW explicitamente. |
| TreeView_EnsureVisible | Garante que um item de exibição de árvore esteja visível, expandindo o item pai ou rolando o controle de exibição de árvore, se necessário. Você pode usar essa macro ou enviar a mensagem TVM_ENSUREVISIBLE explicitamente. |
| TreeView_Expand | A macro TreeView_Expand expande ou recolhe a lista de itens filho associados ao item pai especificado, se houver. Você pode usar essa macro ou enviar a mensagem TVM_EXPAND explicitamente. |
| TreeView_GetBkColor | Recupera a cor da tela de fundo atual do controle. Você pode usar essa macro ou enviar a mensagem TVM_GETBKCOLOR explicitamente. |
| TreeView_GetCheckState | Obtém o estado de verificação do item especificado. Você também pode usar a mensagem TVM_GETITEMSTATE diretamente. |
| TreeView_GetChild | Recupera o primeiro item filho do item de exibição de árvore especificado. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_CHILD. |
| TreeView_GetCount | Recupera uma contagem dos itens em um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETCOUNT explicitamente. |
| TreeView_GetDropHilight | Recupera o item de exibição de árvore que é o destino de uma operação de arrastar e soltar. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_DROPHILITE. |
| TreeView_GetEditControl | Recupera o identificador para o controle de edição que está sendo usado para editar o texto de um item de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETEDITCONTROL explicitamente. |
| TreeView_GetExtendedStyle | Recupera o estilo estendido para um controle de exibição de árvore especificado. Use essa macro ou envie a mensagem TVM_GETEXTENDEDSTYLE explicitamente. |
| TreeView_GetFirstVisible | Recupera o primeiro item visível em uma janela de controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_FIRSTVISIBLE. |
| TreeView_GetImageList | Recupera o identificador para a lista de imagens de estado ou normal associada a um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETIMAGELIST explicitamente. |
| TreeView_GetIndent | Recupera a quantidade, em pixels, de que os itens filho são recuados em relação aos itens pai. Você pode usar essa macro ou enviar a mensagem TVM_GETINDENT explicitamente. |
| TreeView_GetInsertMarkColor | Recupera a cor usada para desenhar a marca de inserção para o modo de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETINSERTMARKCOLOR explicitamente. |
| TreeView_GetISearchString | Recupera a cadeia de caracteres de pesquisa incremental para um controle de exibição de árvore. O controle de exibição de árvore usa a cadeia de caracteres de pesquisa incremental para selecionar um item com base em caracteres digitado pelo usuário. Você pode usar essa macro ou enviar a mensagem TVM_GETISEARCHSTRING explicitamente. |
| TreeView_GetItem | Recupera alguns ou todos os atributos de um item de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETITEM explicitamente. |
| TreeView_GetItemHeight | Recupera a altura atual dos itens de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETITEMHEIGHT explicitamente. |
| TreeView_GetItemPartRect | Recupera o maior retângulo delimitador possível que constitui a "zona de ocorrência" para uma parte especificada de um item. Use essa macro ou envie a mensagem TVM_GETITEMPARTRECT explicitamente. |
| TreeView_GetItemRect | Recupera o retângulo delimitador para um item de exibição de árvore e indica se o item está visível. Você pode usar essa macro ou enviar a mensagem TVM_GETITEMRECT explicitamente. |
| TreeView_GetItemState | Recupera alguns ou todos os atributos de estado de um item de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETITEMSTATE explicitamente. |
| TreeView_GetLastVisible | Recupera o último item expandido em um controle de exibição de árvore. Isso não recupera o último item visível na janela de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_LASTVISIBLE. |
| TreeView_GetLineColor | Obtém a cor da linha atual. Você também pode usar a mensagem TVM_GETLINECOLOR diretamente. |
| TreeView_GetNextItem | Recupera o item de exibição de árvore que tem a relação especificada com um item especificado. Você pode usar essa macro, usar uma das macros TreeView_Get descritas abaixo ou enviar a mensagem TVM_GETNEXTITEM explicitamente. |
| TreeView_GetNextSelected | Recupera o item de exibição de árvore que tem a relação TVGN_NEXTSELECTED com um item de árvore especificado. |
| TreeView_GetNextSibling | Recupera o próximo item irmão de um item especificado em um controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_NEXT. |
| TreeView_GetNextVisible | Recupera o próximo item visível que segue um item especificado em um controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_NEXTVISIBLE. |
| TreeView_GetParent | Recupera o item pai do item de exibição de árvore especificado. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_PARENT. |
| TreeView_GetPrevSibling | Recupera o item irmão anterior de um item especificado em um controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_PREVIOUS. |
| TreeView_GetPrevVisible | Recupera o primeiro item visível que precede um item especificado em um controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_PREVIOUSVISIBLE. |
| TreeView_GetRoot | Recupera o item superior ou muito primeiro do controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_ROOT. |
| TreeView_GetScrollTime | Recupera o tempo máximo de rolagem para o controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETSCROLLTIME explicitamente. |
| TreeView_GetSelectedCount | Não implementado. |
| TreeView_GetSelection | Recupera o item selecionado no momento em um controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem TVM_GETNEXTITEM com o sinalizador TVGN_CARET. |
| TreeView_GetTextColor | Recupera a cor do texto atual do controle. Você pode usar essa macro ou enviar a mensagem TVM_GETTEXTCOLOR explicitamente. |
| TreeView_GetToolTips | Recupera o identificador para o controle de dica de ferramenta filho usado por um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETTOOLTIPS explicitamente. |
| TreeView_GetUnicodeFormat | Recupera o sinalizador de formato de caractere Unicode para o controle. Você pode usar essa macro ou enviar a mensagem TVM_GETUNICODEFORMAT explicitamente. |
| TreeView_GetVisibleCount | Obtém o número de itens que podem ser totalmente visíveis na janela do cliente de um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETVISIBLECOUNT explicitamente. |
| TreeView_HitTest | Determina o local do ponto especificado em relação à área do cliente de um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_HITTEST explicitamente. |
| TreeView_InsertItem | Insere um novo item em um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_INSERTITEM explicitamente. |
| TreeView_MapAccIDToHTREEITEM | Mapeia uma ID de acessibilidade para um HTREEITEM. Você pode usar essa macro ou enviar a mensagem TVM_MAPACCIDTOHTREEITEM explicitamente. |
| TreeView_MapHTREEITEMtoAccID | Mapeia um HTREEITEM para uma ID de acessibilidade. Você pode usar essa macro ou enviar a mensagem TVM_MAPHTREEITEMTOACCID explicitamente. |
| TreeView_Select | Seleciona o item de exibição de árvore especificado, rola o item para a exibição ou redesenha o item no estilo usado para indicar o destino de uma operação de arrastar e soltar. Você pode usar essa macro ou as macros TreeView_SelectItem, TreeView_SelectSetFirstVisibleou TreeView_SelectDropTarget ou enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SelectDropTarget | Redesenhe um item de controle de exibição de árvore especificado no estilo usado para indicar o destino de uma operação de arrastar e soltar. Você pode usar essa macro ou a macro TreeView_Select ou enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SelectItem | Seleciona o item de exibição de árvore especificado. Você pode usar essa macro ou a macro TreeView_Select ou enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SelectSetFirstVisible | Rola o controle de exibição de árvore verticalmente para garantir que o item especificado esteja visível. Se possível, o item especificado se tornará o primeiro item visível na parte superior da janela do controle. Você pode usar essa macro ou a macro TreeView_Select ou enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SetAutoScrollInfo | Define as informações usadas para determinar as características de rolagem automática. Use essa macro ou envie a mensagem TVM_SETAUTOSCROLLINFO explicitamente. |
| TreeView_SetBkColor | Define a cor da tela de fundo do controle. Você pode usar essa macro ou enviar a mensagem TVM_SETBKCOLOR explicitamente. |
| TreeView_SetBorder |
destinado ao uso interno; não recomendado para uso em aplicativos. Define o tamanho da borda para os itens em um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETBORDER explicitamente. |
| TreeView_SetCheckState | Define a imagem de estado do item como "marcada" ou "desmarcada". Você também pode usar a mensagem TVM_SETITEM diretamente. |
| TreeView_SetExtendedStyle | Define o estilo estendido para um controle TreeView especificado. Use essa macro ou envie a mensagem TVM_SETEXTENDEDSTYLE explicitamente. |
| TreeView_SetHot |
destinado ao uso interno; não recomendado para uso em aplicativos. Define o item quente para um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETHOT explicitamente. |
| TreeView_SetImageList | Define a lista de imagens normais ou de estado para um controle de exibição de árvore e redesenhe o controle usando as novas imagens. Você pode usar essa macro ou enviar a mensagem TVM_SETIMAGELIST explicitamente. |
| TreeView_SetIndent | Define a largura do recuo para um controle de exibição de árvore e redesenhe o controle para refletir a nova largura. Você pode usar essa macro ou enviar a mensagem TVM_SETINDENT explicitamente. |
| TreeView_SetInsertMark | Define a marca de inserção em um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETINSERTMARK explicitamente. |
| TreeView_SetInsertMarkColor | Define a cor usada para desenhar a marca de inserção para o modo de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETINSERTMARKCOLOR explicitamente. |
| TreeView_SetItem | A macro TreeView_SetItem define alguns ou todos os atributos de um item de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETITEM explicitamente. |
| TreeView_SetItemHeight | Define a altura dos itens de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETITEMHEIGHT explicitamente. |
| TreeView_SetItemState | Define os atributos de estado de um item de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETITEM explicitamente. |
| TreeView_SetLineColor | Define a cor da linha atual. Você também pode usar a mensagem TVM_SETLINECOLOR diretamente. |
| TreeView_SetScrollTime | Define o tempo máximo de rolagem para o controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETSCROLLTIME explicitamente. |
| TreeView_SetTextColor | Define a cor do texto do controle. Você pode usar essa macro ou enviar a mensagem TVM_SETTEXTCOLOR explicitamente. |
| TreeView_SetToolTips | Define o controle de dica de ferramenta filho de um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SETTOOLTIPS explicitamente. |
| TreeView_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 TVM_SETUNICODEFORMAT explicitamente. |
| TreeView_ShowInfoTip | Mostra a dica de informações de um item especificado em um controle de exibição de árvore. Use essa macro ou envie a mensagem TVM_SHOWINFOTIP explicitamente. |
| TreeView_SortChildren | Classifica os itens filho do item pai especificado em um controle de exibição de árvore. Você pode usar essa macro ou enviar a mensagem TVM_SORTCHILDREN explicitamente. |
| TreeView_SortChildrenCB | Classifica itens de exibição de árvore usando uma função de retorno de chamada definida pelo aplicativo que compara os itens. Você pode usar essa macro ou enviar a mensagem TVM_SORTCHILDRENCB explicitamente. |
Mensagens
| Tópico | Conteúdo |
|---|---|
| TVM_CREATEDRAGIMAGE | Cria um bitmap arrastando para o item especificado em um controle de exibição de árvore. A mensagem também cria uma lista de imagens para o bitmap e adiciona o bitmap à lista de imagens. Um aplicativo pode exibir a imagem ao arrastar o item usando as funções de lista de imagens. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_CreateDragImage. |
| TVM_DELETEITEM | Remove um item e todos os seus descendentes de um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_DeleteItem. |
| TVM_EDITLABEL | Inicia a edição in-loco do texto do item especificado, substituindo o texto do item por um controle de edição de linha única que contém o texto. Essa mensagem seleciona implicitamente e concentra o item especificado. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_EditLabel. |
| TVM_ENDEDITLABELNOW | Encerra a edição do rótulo de um item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_EndEditLabelNow. |
| TVM_ENSUREVISIBLE | Garante que um item de exibição de árvore esteja visível, expandindo o item pai ou rolando o controle de exibição de árvore, se necessário. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_EnsureVisible. |
| TVM_EXPAND | A mensagem TVM_EXPAND expande ou recolhe a lista de itens filho associados ao item pai especificado, se houver. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_Expand. |
| TVM_GETBKCOLOR | Recupera a cor da tela de fundo atual do controle. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetBkColor. |
| TVM_GETCOUNT | Recupera uma contagem dos itens em um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetCount. |
| TVM_GETEDITCONTROL | Recupera o identificador para o controle de edição que está sendo usado para editar o texto de um item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetEditControl. |
| TVM_GETEXTENDEDSTYLE | Recupera o estilo estendido para um controle de exibição de árvore. Envie essa mensagem explicitamente ou usando a macro TreeView_GetExtendedStyle. |
| TVM_GETIMAGELIST | Recupera o identificador para a lista de imagens de estado ou normal associada a um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetImageList. |
| TVM_GETINDENT | Recupera a quantidade, em pixels, de que os itens filho são recuados em relação aos itens pai. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetIndent. |
| TVM_GETINSERTMARKCOLOR | Recupera a cor usada para desenhar a marca de inserção para o modo de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetInsertMarkColor. |
| TVM_GETISEARCHSTRING | Recupera a cadeia de caracteres de pesquisa incremental para um controle de exibição de árvore. O controle de exibição de árvore usa a cadeia de caracteres de pesquisa incremental para selecionar um item com base em caracteres digitado pelo usuário. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetISearchString. |
| TVM_GETITEM | Recupera alguns ou todos os atributos de um item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetItem. |
| TVM_GETITEMHEIGHT | Recupera a altura atual de cada item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetItemHeight. |
| TVM_GETITEMPARTRECT | Não implementado. |
| TVM_GETITEMRECT | Recupera o retângulo delimitador para um item de exibição de árvore e indica se o item está visível. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetItemRect. |
| TVM_GETITEMSTATE | Recupera alguns ou todos os atributos de estado de um item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetItemState. |
| TVM_GETLINECOLOR | A mensagem TVM_GETLINECOLOR obtém a cor da linha atual. |
| TVM_GETNEXTITEM | Recupera o item de exibição de árvore que tem a relação especificada com um item especificado. Você pode enviar essa mensagem explicitamente usando a macro TreeView_GetNextItem. |
| TVM_GETSCROLLTIME | Recupera o tempo máximo de rolagem para o controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetScrollTime. |
| TVM_GETSELECTEDCOUNT | Não implementado. |
| TVM_GETTEXTCOLOR | Recupera a cor do texto atual do controle. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetTextColor. |
| TVM_GETTOOLTIPS | Recupera o identificador para o controle de dica de ferramenta filho usado por um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetToolTips. |
| TVM_GETUNICODEFORMAT | Recupera o sinalizador de formato de caractere Unicode para o controle. Você pode enviar essa mensagem explicitamente ou usar a macro TreeView_GetUnicodeFormat. |
| TVM_GETVISIBLECOUNT | Obtém o número de itens que podem ser totalmente visíveis na janela do cliente de um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetVisibleCount. |
| TVM_HITTEST | Determina o local do ponto especificado em relação à área do cliente de um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_HitTest. |
| TVM_INSERTITEM | Insere um novo item em um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_InsertItem. |
| TVM_MAPACCIDTOHTREEITEM | Mapeia uma ID de acessibilidade para um HTREEITEM. |
| TVM_MAPHTREEITEMTOACCID | Mapeia um HTREEITEM para uma ID de acessibilidade. |
| TVM_SELECTITEM | Seleciona o item de exibição de árvore especificado, rola o item para a exibição ou redesenha o item no estilo usado para indicar o destino de uma operação de arrastar e soltar. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_Select, TreeView_SelectItemou TreeView_SelectDropTarget. |
| TVM_SETAUTOSCROLLINFO | Define as informações usadas para determinar as características de rolagem automática. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetAutoScrollInfo. |
| TVM_SETBKCOLOR | Define a cor da tela de fundo do controle. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetBkColor. |
| TVM_SETBORDER |
destinado ao uso interno; não recomendado para uso em aplicativos. Define o tamanho da borda para os itens em um controle de exibição de árvore. Você pode enviar a mensagem explicitamente ou usando a macro TreeView_SetBorder. |
| TVM_SETEXTENDEDSTYLE | Informa o controle de exibição de árvore para definir estilos estendidos. Envie esta mensagem ou use a macro TreeView_SetExtendedStyle. |
| TVM_SETHOT |
destinado ao uso interno; não recomendado para uso em aplicativos. Define o item quente para um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetHot. |
| TVM_SETIMAGELIST | Define a lista de imagens normais ou de estado para um controle de exibição de árvore e redesenhe o controle usando as novas imagens. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetImageList. |
| TVM_SETINDENT | Define a largura do recuo para um controle de exibição de árvore e redesenhe o controle para refletir a nova largura. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetIndent. |
| TVM_SETINSERTMARK | Define a marca de inserção em um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetInsertMark. |
| TVM_SETINSERTMARKCOLOR | Define a cor usada para desenhar a marca de inserção para o modo de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetInsertMarkColor. |
| TVM_SETITEM | A mensagem TVM_SETITEM define alguns ou todos os atributos de um item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetItem. |
| TVM_SETITEMHEIGHT | Define a altura dos itens de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetItemHeight. |
| TVM_SETLINECOLOR | A mensagem TVM_SETLINECOLOR define a cor da linha atual. |
| TVM_SETSCROLLTIME | Define o tempo máximo de rolagem para o controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetScrollTime. |
| TVM_SETTEXTCOLOR | Define a cor do texto do controle. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetTextColor. |
| TVM_SETTOOLTIPS | Define o controle de dica de ferramenta filho de um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetToolTips. |
| TVM_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 TreeView_SetUnicodeFormat. |
| TVM_SHOWINFOTIP | Mostra a dica de informações de um item especificado em um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_ShowInfoTip.. |
| TVM_SORTCHILDREN | Classifica os itens filho do item pai especificado em um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SortChildren. |
| TVM_SORTCHILDRENCB | Classifica itens de exibição de árvore usando uma função de retorno de chamada definida pelo aplicativo que compara os itens. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SortChildrenCB. |
Notificações
| Tópico | Conteúdo |
|---|---|
| NM_CLICK (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore que o usuário clicou no botão esquerdo do mouse dentro do controle. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_CUSTOMDRAW (exibição de árvore) | Enviado por um controle de exibição de árvore para notificar sua janela pai sobre operações de desenho. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_DBLCLK (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore 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_KILLFOCUS (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore de que o controle perdeu o foco de entrada. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_RCLICK (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore que o usuário clicou no botão direito do mouse dentro do controle. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_RDBLCLK (exibição de árvore) | Notifica o pai de um controle de exibição de árvore que o usuário clicou duas vezes no botão direito do mouse dentro do controle. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_RETURN (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore de que o controle tem o foco de entrada e que o usuário pressionou a tecla. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_SETCURSOR (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore de que o controle está definindo o cursor em resposta a uma mensagem de WM_SETCURSOR. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| NM_SETFOCUS (exibição de árvore) | Notifica a janela pai de um controle de exibição de árvore de que o controle recebeu o foco de entrada. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| TVN_ASYNCDRAW | Enviado por um controle de exibição de árvore para seu pai quando o desenho de um ícone ou sobreposição falha. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_BEGINDRAG | Notifica a janela pai de um controle de exibição de árvore de que uma operação de arrastar e soltar envolvendo o botão esquerdo do mouse está sendo iniciada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_BEGINLABELEDIT | Notifica a janela pai de um controle de exibição de árvore sobre o início da edição de rótulo para um item. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_BEGINRDRAG | Notifica a janela pai de um controle de exibição de árvore sobre o início de uma operação de arrastar e soltar envolvendo o botão direito do mouse. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_DELETEITEM | Notifica a janela pai de um controle de exibição de árvore de que um item está sendo excluído. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_ENDLABELEDIT | Notifica a janela pai de um controle de exibição de árvore sobre o fim da edição de rótulo para um item. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_GETDISPINFO | Solicita que a janela pai de um controle de exibição de árvore forneça informações necessárias para exibir ou classificar um item. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_GETINFOTIP | Enviado por um controle de exibição de árvore que tem o estilo TVS_INFOTIP. Essa notificação é enviada quando o controle está solicitando informações adicionais de texto a serem exibidas em uma dica de ferramenta. A notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
| TVN_ITEMCHANGED | Notifica a janela pai de um controle de exibição de árvore de que os atributos de item foram alterados. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_ITEMCHANGING | Notifica a janela pai de um controle de exibição de árvore de que os atributos de item estão prestes a ser alterados. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_ITEMEXPANDED | Notifica a janela pai de um controle de exibição de árvore de que a lista de itens filho de um item pai foi expandida ou recolhida. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_ITEMEXPANDING | Notifica a janela pai de um controle de exibição de árvore de que a lista de itens filho de um item pai está prestes a expandir ou recolher. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_KEYDOWN | Notifica a janela pai de um controle de exibição de árvore de que o usuário pressionou uma tecla e o controle de exibição de árvore tem o foco de entrada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_SELCHANGED | Notifica a janela pai de um controle de exibição de árvore de que a seleção foi alterada de um item para outro. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_SELCHANGING | Notifica a janela pai de um controle de exibição de árvore de que a seleção está prestes a mudar de um item para outro. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_SETDISPINFO | Notifica a janela pai de um controle de exibição de árvore de que ele deve atualizar as informações que mantém sobre um item. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY. |
| TVN_SINGLEEXPAND | Enviado por um controle de exibição de árvore com o estilo TVS_SINGLEEXPAND quando o usuário abre ou fecha um item de árvore usando um único clique do mouse. Essa notificação é enviada na forma de uma mensagem de WM_NOTIFY. |
Estruturas
| Tópico | Conteúdo |
|---|---|
| NMTREEVIEW | Contém informações sobre um código de notificação de exibição de árvore. Essa estrutura é idêntica à estrutura NM_TREEVIEW, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| NMTVASYNCDRAW | Contém uma explicação de por que o desenho de um ícone ou item de árvore de sobreposição falhou. Essa estrutura é enviada em uma notificação de TVN_ASYNCDRAW. Defina o membro dwRetFlags para indicar qual ação o controle deve tomar. Observe que um desenho pode falhar se não houver nenhuma imagem; em outras palavras, quando a imagem do ícone não tiver sido extraída. |
| NMTVCUSTOMDRAW | Contém informações específicas para um NM_CUSTOMDRAW (modo de exibição de árvore) código de notificação enviado por um controle de exibição de árvore. |
| NMTVDISPINFO | Contém e recebe informações de exibição para um item de exibição de árvore. Essa estrutura é idêntica à estrutura de TV_DISPINFO, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| NMTVDISPINFOEX | Contém informações relativas a informações de notificação do TreeView estendidas. |
| NMTVGETINFOTIP | Contém e recebe informações de item de exibição de árvore necessárias para exibir uma dica de ferramenta para um item. Essa estrutura é usada com o código de notificação TVN_GETINFOTIP. |
| NMTVITEMCHANGE | Contém informações sobre uma alteração de item de exibição de árvore. Essa estrutura é enviada com as notificações TVN_ITEMCHANGED e TVN_ITEMCHANGING. |
| NMTVITEMRECT | Não há suporte no momento. |
| NMTVKEYDOWN | Contém informações sobre um evento de teclado em um controle de exibição de árvore. Essa estrutura é usada com o código de notificação TVN_KEYDOWN. A estrutura é idêntica à estrutura TV_KEYDOWN, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| NMTVSTATEIMAGECHANGING | Contém informações sobre uma imagem de estado de exibição de árvore alterando o código de notificação. |
| TVGETITEMPARTRECTINFO | Contém informações para identificar a "zona de ocorrência" para uma parte especificada de um item de árvore. A estrutura é usada com a mensagem TVM_GETITEMPARTRECT e a macro TreeView_GetItemPartRect. |
| TVHITTESTINFO | Contém informações usadas para determinar o local de um ponto relativo a um controle de exibição de árvore. Essa estrutura é usada com a mensagem TVM_HITTEST. A estrutura é idêntica à estrutura de TV_HITTESTINFO, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| TVINSERTSTRUCT | Contém informações usadas para adicionar um novo item a um controle de exibição de árvore. Essa estrutura é usada com a mensagem TVM_INSERTITEM. A estrutura é idêntica à estrutura TV_INSERTSTRUCT, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| TVITEM | Especifica ou recebe atributos de um item de exibição de árvore. Essa estrutura é idêntica à estrutura de TV_ITEM, mas foi renomeada para seguir as convenções de nomenclatura atuais. Novos aplicativos devem usar essa estrutura. |
| TVITEMEX | Especifica ou recebe atributos de um item de exibição de árvore. Essa estrutura é um aprimoramento da estruturaTVITEM. Novos aplicativos devem usar essa estrutura quando apropriado. |
| TVSORTCB | Contém informações usadas para classificar itens filho em um controle de exibição de árvore. Essa estrutura é usada com a mensagem TVM_SORTCHILDRENCB. Essa estrutura é idêntica à estrutura TV_SORTCB, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
Constantes
| Tópico | Conteúdo |
|---|---|
| estilos estendidos de controle deTree-View | Esta seção lista os estilos estendidos usados ao criar controles de exibição de árvore. O valor dos estilos estendidos é uma combinação bit a bit desses estilos. |
| Estados do item de controle Tree-View | Esta seção lista os sinalizadores de estado do item usados para indicar o estado de um item em um controle de exibição de árvore. |
| estilos de janela de controle Tree-View | Esta seção lista os estilos de janela usados ao criar controles de exibição de árvore. |