Compartilhar via

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.
  • Last updated on