messaggio TVM_EXPAND

Il messaggio TVM_EXPAND espande o comprime l'elenco di elementi figlio associati all'elemento padre specificato, se presente. È possibile inviare questo messaggio in modo esplicito o usando la macro TreeView_Expand .

Parametri

wParam

Flag di azione. Questo parametro può essere uno o più dei valori seguenti:

Valore Significato
TVE_COLLAPSE
Comprime l'elenco.
TVE_COLLAPSERESET
Comprime l'elenco e rimuove gli elementi figlio. Il flag di stato TVIS_EXPANDEDONCE viene reimpostato. Questo flag deve essere usato con il flag di TVE_COLLAPSE.
TVE_EXPAND
Espande l'elenco.
TVE_EXPANDPARTIAL
Versione 4.70. Espande parzialmente l'elenco. In questo stato gli elementi figlio sono visibili e viene visualizzato il segno più dell'elemento padre (+), che indica che può essere espanso. Questo flag deve essere usato in combinazione con il flag di TVE_EXPAND.
TVE_TOGGLE
Comprime l'elenco se è espanso o lo espande se è compresso.

lParam

Gestire l'elemento padre per espandere o comprimere.

Valore restituito

Restituisce un valore diverso da zero se l'operazione ha avuto esito positivo o zero in caso contrario.

Commenti

L'espansione di un nodo già espanso viene considerata un'operazione riuscita e SendMessage restituisce un valore diverso da zero. La compressione di un nodo restituisce zero se il nodo è già compresso; in caso contrario, restituisce non zero. Il tentativo di espandere o comprimere un nodo senza elementi figlio è considerato un errore e SendMessage restituisce zero.

Quando un elemento viene prima espanso da un messaggio di TVM_EXPAND , l'azione genera TVN_ITEMEXPANDING e TVN_ITEMEXPANDED codici di notifica e viene impostato il flag di stato TVIS_EXPANDEDONCE dell'elemento. Purché questo flag di stato rimanga impostato, i messaggi successivi TVM_EXPAND non generano notifiche di TVN_ITEMEXPANDING o di TVN_ITEMEXPANDED. Per reimpostare il flag di stato TVIS_EXPANDEDONCE , è necessario inviare un messaggio di TVM_EXPAND con i flag TVE_COLLAPSE e TVE_COLLAPSERESET impostati. Il tentativo di impostare in modo esplicito TVIS_EXPANDEDONCE comporta un comportamento imprevedibile.

L'operazione di espansione potrebbe non riuscire se il proprietario del controllo treeview nega l'operazione in risposta a una notifica di TVN_ITEMEXPANDING .

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h