TreeView_Expand macro (commctrl.h)

Artigo
10/24/2024

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.

Sintaxe

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parâmetros

hwnd

Tipo: HWND

Manipule para um controle de exibição de árvore.

hitem

Tipo: HTREEITEM

Manipule para o item pai que será expandido ou recolhido.

code

Tipo: UINT

Sinalizador de ação. Para obter uma lista de valores possíveis, consulte a descrição do parâmetro wParam em TVM_EXPAND.

Valor de retorno

Tipo: BOOL

Retornará diferente de zero se a operação tiver sido bem-sucedida ou zero caso contrário.

Observações

Expandir um nó que já foi expandido ou recolher um nó que já foi recolhido é considerado uma operação bem-sucedida e a macro retorna um valor diferente de zero. A tentativa de expandir ou recolher um nó que não tem filhos é considerada uma falha e o valor retornado é zero.

Quando um item é expandido pela primeira vez por uma mensagem de TVM_EXPAND, a ação gera códigos de notificação TVN_ITEMEXPANDING e TVN_ITEMEXPANDED e o sinalizador de estado TVIS_EXPANDEDONCE do item é definido. Enquanto esse sinalizador de estado permanecer definido, as mensagens de TVM_EXPAND subsequentes não geram notificações TVN_ITEMEXPANDING ou TVN_ITEMEXPANDED. Para redefinir o sinalizador de estado TVIS_EXPANDEDONCE, você deve enviar uma mensagem TVM_EXPAND com os sinalizadores TVE_COLLAPSE e TVE_COLLAPSERESET definidos. A tentativa de definir explicitamente TVIS_EXPANDEDONCE resultará em um comportamento imprevisível.

A operação de expansão poderá falhar se o proprietário do controle treeview negar a operação em resposta a uma notificação de TVN_ITEMEXPANDING.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via