Compartilhar via


TVM_EXPAND mensagem

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 .

Parâmetros

wParam

Sinalizador de ação. Esse parâmetro pode usar um dos valores a seguir:

Valor Significado
TVE_COLLAPSE
Recolhe a lista.
TVE_COLLAPSERESET
Recolhe a lista e remove os itens filho. O sinalizador de estado TVIS_EXPANDEDONCE é redefinido. Esse sinalizador deve ser usado com o sinalizador TVE_COLLAPSE.
TVE_EXPAND
Expande a lista.
TVE_EXPANDPARTIAL
Versão 4.70. Expande parcialmente a lista. Nesse estado, os itens filho são visíveis e o sinal de adição do item pai (+), indicando que ele pode ser expandido, é exibido. Esse sinalizador deve ser usado em combinação com o sinalizador TVE_EXPAND.
TVE_TOGGLE
Recolherá a lista se ela for expandida ou expandi-la se ela for recolhida.

lParam

Manipule para o item pai para expandir ou recolher.

Valor retornado

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

Comentários

Expandir um nó que já está expandido é considerado uma operação bem-sucedida e SendMessage retorna um valor diferente de zero. Recolher um nó retornará zero se o nó já estiver recolhido; caso contrário, retornará diferente de zero. A tentativa de expandir ou recolher um nó que não tem filhos é considerada uma falha e SendMessage retorna 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 de 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. Tentar 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
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h