Vista da árvore
Esta seção contém informações sobre os elementos de programação usados com controles de exibição em árvore.
Visão geral
| Tópico | Índice |
|---|---|
| Sobre Tree-View controles | 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 em árvore. |
Macros
| Tópico | Índice |
|---|---|
| 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 em árvore. |
| TreeView_DeleteItem | Remove um item e todos os seus descendentes de um controle de exibição em á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 contendo o texto. Esta macro implicitamente seleciona e concentra o item especificado. Você pode usar essa macro ou enviar a mensagem TVM_EDITLABEL explicitamente. |
| TreeView_EndEditLabelNow | Termina a edição do rótulo de um item de exibição em árvore. Você pode usar essa macro ou enviar a mensagem TVM_ENDEDITLABELNOW explicitamente. |
| TreeView_EnsureVisible | Garante que um item de exibição em árvore esteja visível, expandindo o item pai ou rolando o controle de exibição em á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 de plano 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 esta macro ou envie a mensagem TVM_GETEXTENDEDSTYLE explicitamente. |
| TreeView_GetFirstVisible | Recupera o primeiro item visível em uma janela de controle de exibição em árvore. Você pode usar essa macro ou enviar explicitamente a mensagem de TVM_GETNEXTITEM com o sinalizador TVGN_FIRSTVISIBLE. |
| TreeView_GetImageList | Recupera o identificador para a lista de imagens normais ou de estado associadas a um controle de exibição em árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETIMAGELIST explicitamente. |
| TreeView_GetIndent | Recupera a quantidade, em pixels, 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 a exibição em á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 em árvore. O controle de exibição em árvore usa a cadeia de caracteres de pesquisa incremental para selecionar um item com base em caracteres digitados 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 em árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETITEM explicitamente. |
| TreeView_GetItemHeight | Recupera a altura atual dos itens de exibição em á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 acerto" para uma parte especificada de um item. Use esta macro ou envie a mensagem TVM_GETITEMPARTRECT explicitamente. |
| TreeView_GetItemRect | Recupera o retângulo delimitador de um item de exibição em á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 em árvore. Você pode usar essa macro ou enviar explicitamente a mensagem de 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 contém 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 contém 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 de 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 de 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 primeiro item superior ou o primeiro do controle de exibição em árvore. Você pode usar essa macro ou enviar explicitamente a mensagem de TVM_GETNEXTITEM com o sinalizador TVGN_ROOT. |
| TreeView_GetScrollTime | Recupera o tempo máximo de rolagem para o controle de exibição em árvore. Você pode usar essa macro ou enviar a mensagem TVM_GETSCROLLTIME explicitamente. |
| TreeView_GetSelectedCount | Não implementado. |
| TreeView_GetSelection | Recupera o item selecionado atualmente em um controle de exibição de árvore. Você pode usar essa macro ou enviar explicitamente a mensagem de 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 em á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 em á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 um 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 em árvore especificado, rola o item para exibição ou redesenha o item no estilo usado para indicar o destino de uma operação de arrastar e soltar. Pode utilizar esta macro ou as macros TreeView_SelectItem, TreeView_SelectSetFirstVisibleou TreeView_SelectDropTarget ou pode enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SelectDropTarget | Redesenha 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 pode enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SelectItem | Seleciona o item de exibição em árvore especificado. Você pode usar essa macro ou a macro TreeView_Select ou pode enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SelectSetFirstVisible | Rola o controle de exibição em árvore verticalmente para garantir que o item especificado esteja visível. Se possível, o item especificado torna-se o primeiro item visível na parte superior da janela do controle. Você pode usar essa macro ou a macro TreeView_Select ou pode enviar a mensagem TVM_SELECTITEM explicitamente. |
| TreeView_SetAutoScrollInfo | Define as informações usadas para determinar as características de rolagem automática. Use esta macro ou envie a mensagem TVM_SETAUTOSCROLLINFO explicitamente. |
| TreeView_SetBkColor | Define a cor do plano de fundo do controle. Você pode usar essa macro ou enviar a mensagem TVM_SETBKCOLOR explicitamente. |
| TreeView_SetBorder |
Destinados a uso interno; Não recomendado para uso em aplicações. 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 esta macro ou envie a mensagem TVM_SETEXTENDEDSTYLE explicitamente. |
| TreeView_SetHot |
Destinados a uso interno; Não recomendado para uso em aplicações. Define o item ativo para um controle de exibição em á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 em árvore e redesenha o controle usando as novas imagens. Você pode usar essa macro ou enviar a mensagem TVM_SETIMAGELIST explicitamente. |
| TreeView_SetIndent | Define a largura de recuo para um controle de exibição em árvore e redesenha 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 em á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 em á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 em á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 em á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. Esta mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle. Você pode usar essa macro ou enviar a mensagem TVM_SETUNICODEFORMAT explicitamente. |
| TreeView_ShowInfoTip | Mostra a dica de informações para um item especificado em um controle de exibição de árvore. Use esta 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 em á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 | Índice |
|---|---|
| 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 em á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 contendo o texto. Esta mensagem implicitamente seleciona e concentra o item especificado. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_EditLabel. |
| TVM_ENDEDITLABELNOW | Termina a edição do rótulo de um item de exibição em árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_EndEditLabelNow. |
| TVM_ENSUREVISIBLE | Garante que um item de exibição em árvore esteja visível, expandindo o item pai ou rolando o controle de exibição em á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 de plano 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 em árvore. Envie esta mensagem explicitamente ou usando a macro TreeView_GetExtendedStyle. |
| TVM_GETIMAGELIST | Recupera o identificador para a lista de imagens normais ou de estado associadas a um controle de exibição em árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetImageList. |
| TVM_GETINDENT | Recupera a quantidade, em pixels, 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 a exibição em á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 em árvore. O controle de exibição em árvore usa a cadeia de caracteres de pesquisa incremental para selecionar um item com base em caracteres digitados 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 em á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 em á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 de um item de exibição em á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 contém 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 em á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 em á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 em á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 um ID de acessibilidade para um HTREEITEM. |
| TVM_MAPHTREEITEMTOACCID | Mapeia um HTREEITEM para uma ID de acessibilidade. |
| TVM_SELECTITEM | Seleciona o item de exibição em árvore especificado, rola o item para 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 do plano de fundo do controle. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetBkColor. |
| TVM_SETBORDER |
Destinados a uso interno; Não recomendado para uso em aplicações. 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 |
Destinados a uso interno; Não recomendado para uso em aplicações. Define o item ativo para um controle de exibição em á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 em árvore e redesenha o controle usando as novas imagens. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetImageList. |
| TVM_SETINDENT | Define a largura de recuo para um controle de exibição em árvore e redesenha 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 em á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 em árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_SetItem. |
| TVM_SETITEMHEIGHT | Define a altura dos itens de exibição em á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 em á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 em á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. Esta mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle. Você pode enviar essa mensagem explicitamente ou usar a macro TreeView_SetUnicodeFormat. |
| TVM_SHOWINFOTIP | Mostra a dica de informações para 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 em á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 | Índice |
|---|---|
| NM_CLICK (vista em árvore) | Notifica a janela pai de um controle de exibição em árvore de que o usuário clicou no botão esquerdo do mouse dentro do controle. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_CUSTOMDRAW (vista em árvore) | Enviado por um controle de exibição de árvore para notificar sua janela pai sobre operações de desenho. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_DBLCLK (vista em árvore) | Notifica a janela pai de um controle de exibição em árvore de que o usuário clicou duas vezes no botão esquerdo do mouse dentro do controle. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_KILLFOCUS (vista em árvore) | Notifica a janela pai de um controle de exibição de árvore de que o controle perdeu o foco de entrada. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_RCLICK (vista em árvore) | Notifica a janela pai de um controle de exibição em árvore de que o usuário clicou no botão direito do mouse dentro do controle. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_RDBLCLK (vista em á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. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_RETURN (vista em á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. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_SETCURSOR (vista em á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 WM_SETCURSOR. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| NM_SETFOCUS (vista em árvore) | Notifica a janela pai de um controle de exibição em árvore de que o controle recebeu o foco de entrada. Esta notificação é enviada sob a forma de uma mensagem 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 falhou. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_BEGINDRAG | Notifica a janela pai de um controle de exibição em árvore de que uma operação de arrastar e soltar envolvendo o botão esquerdo do mouse está sendo iniciada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_BEGINLABELEDIT | Notifica a janela pai de um controle de exibição em árvore sobre o início da edição de rótulos para um item. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_BEGINRDRAG | Notifica a janela pai de um controle de exibição em árvore sobre o início de uma operação de arrastar e soltar envolvendo o botão direito do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_DELETEITEM | Notifica a janela pai de um controle de exibição de árvore de que um item está sendo excluído. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_ENDLABELEDIT | Notifica a janela pai de um controle de exibição em árvore sobre o fim da edição de rótulos de um item. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_GETDISPINFO | Solicita que a janela pai de um controle de exibição em árvore forneça as informações necessárias para exibir ou classificar um item. Este código de notificação é enviado na forma de uma mensagem 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 de texto adicionais a serem exibidas em uma dica de ferramenta. A notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| TVN_ITEMCHANGED | Notifica a janela pai de um controle de exibição de árvore de que os atributos do item foram alterados. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_ITEMCHANGING | Notifica a janela pai de um controle de exibição de árvore de que os atributos do item estão prestes a ser alterados. Este código de notificação é enviado na forma de uma mensagem 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. Este código de notificação é enviado na forma de uma mensagem 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 se expandir ou recolher. Este código de notificação é enviado na forma de uma mensagem 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. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_SELCHANGED | Notifica a janela pai de um controle de exibição em árvore de que a seleção foi alterada de um item para outro. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TVN_SELCHANGING | Notifica a janela pai de um controle de exibição de árvore de que a seleção está prestes a ser alterada de um item para outro. Este código de notificação é enviado na forma de uma mensagem 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. Este código de notificação é enviado na forma de uma mensagem 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. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
Estruturas
| Tópico | Índice |
|---|---|
| NMTREEVIEW | Contém informações sobre um código de notificação de exibição em árvore. Esta estrutura é idêntica à estrutura NM_TREEVIEW, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| NMTVASYNCDRAW | Contém uma explicação do motivo da falha no desenho de um ícone ou item de árvore de sobreposição. Esta estrutura é enviada numa notificação TVN_ASYNCDRAW. Defina o dwRetFlags membro para indicar qual ação o controle deve tomar. Observe que um empate pode falhar se não houver imagem; por outras palavras, quando a imagem do ícone não foi extraída. |
| NMTVCUSTOMDRAW | Contém informações específicas para um NM_CUSTOMDRAW (exibição em árvore) código de notificação enviado por um controle de exibição em árvore. |
| NMTVDISPINFO | Contém e recebe informações de exibição para um item de exibição em árvore. Esta estrutura é idêntica à estrutura TV_DISPINFO, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
| NMTVDISPINFOEX | Contém informações referentes às informações de notificação estendidas do TreeView. |
| NMTVGETINFOTIP | Contém e recebe informações de item de exibição em á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 em árvore. Esta estrutura é enviada com as TVN_ITEMCHANGED e TVN_ITEMCHANGING notificações. |
| NMTVITEMRECT | Não suportado atualmente. |
| NMTVKEYDOWN | Contém informações sobre um evento de teclado em um controle de exibição em á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. |
| NMTVSTATEIMAGEALTERANDO | Contém informações sobre uma imagem de estado de exibição em árvore alterando o código de notificação. |
| TVGETITEMPARTRECTINFO | Contém informações para identificar a "zona de acertos" 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 em árvore. Esta estrutura é usada com a mensagem TVM_HITTEST. A estrutura é idêntica à estrutura 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. Esta 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 em árvore. Esta estrutura é idêntica à estrutura TV_ITEM, mas foi renomeada para seguir as convenções de nomenclatura atuais. Novas aplicações devem usar essa estrutura. |
| TVITEMEX | Especifica ou recebe atributos de um item de exibição em árvore. Esta estrutura é uma melhoria para a TVITEM estrutura. As novas aplicações devem utilizar esta estrutura sempre que adequado. |
| TVSORTCB | Contém informações usadas para classificar itens filho em um controle de exibição de árvore. Esta estrutura é usada com a mensagem TVM_SORTCHILDRENCB. Esta estrutura é idêntica à estrutura TV_SORTCB, mas foi renomeada para seguir as convenções de nomenclatura atuais. |
Constantes
| Tópico | Índice |
|---|---|
| Tree-View controlar estilos estendidos | Esta seção lista os estilos estendidos usados ao criar controles de exibição em árvore. O valor dos estilos estendidos é uma combinação bit a bit desses estilos. |
| Tree-View Estados do item de controle | Esta seção lista os sinalizadores de estado de item usados para indicar o estado de um item em um controle de exibição de árvore. |
| Tree-View Estilos de janela de controle | Esta seção lista os estilos de janela usados ao criar controles de exibição em árvore. |