macro TreeView_Expand (commctrl.h)

La macro TreeView_Expand espande o comprime l'elenco di elementi figlio associati all'elemento padre specificato, se presente. È possibile usare questa macro o inviare in modo esplicito il messaggio TVM_EXPAND .

Sintassi

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

Parametri

hwnd

Tipo: HWND

Gestire un controllo di visualizzazione albero.

hitem

Tipo: HTREEITEM

Gestire l'elemento padre che verrà espanso o compresso.

code

Tipo: UINT

Flag di azione. Per un elenco di valori possibili, vedere la descrizione del parametro flag in TVM_EXPAND.

Valore restituito

nessuno

Osservazioni

L'espansione di un nodo già espanso o la compressione di un nodo già compresso viene considerata un'operazione riuscita e la macro restituisce un valore diverso da zero. Il tentativo di espandere o comprimere un nodo senza elementi figlio è considerato un errore e il valore restituito è 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