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 utilizzare questa macro o inviare il messaggio di TVM_EXPAND in modo esplicito.

Sintassi

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

Parametri

hwnd

Tipo: HWND

Handle in un controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

Handle per l'elemento padre che verrà espanso o compresso.

code

Tipo: UINT

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

Valore restituito

Tipo: BOOL

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

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 espanso per la prima volta 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. Finché questo flag di stato rimane impostato, i messaggi di TVM_EXPAND successivi non generano notifiche TVN_ITEMEXPANDING o 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 comporterà 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.

Fabbisogno