macro TreeView_DeleteItem (commctrl.h)

Rimuove un elemento e tutti i relativi elementi figlio da un controllo visualizzazione albero. È anche possibile inviare il messaggio di TVM_DELETEITEM in modo esplicito.

Sintassi

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

handle HTREEITEM per l'elemento da eliminare. Se hitem è impostato su TVI_ROOT, tutti gli elementi vengono eliminati dal controllo visualizzazione albero. È anche possibile utilizzare la macro TreeView_DeleteAllItems per eliminare tutti gli elementi.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Non è sicuro eliminare elementi in risposta a una notifica, ad esempio TVN_SELCHANGING.

Una volta eliminato un elemento, il relativo handle non è valido e non può essere usato.

La finestra padre riceve un codice di notifica TVN_DELETEITEM quando ogni elemento viene rimosso.

Se l'etichetta dell'elemento viene modificata, l'operazione di modifica viene annullata e la finestra padre riceve il codice di notifica TVN_ENDLABELEDIT.

Se si eliminano tutti gli elementi in un controllo visualizzazione albero con lo stile TVS_NOSCROLL, gli elementi aggiunti successivamente potrebbero non essere visualizzati correttamente. Per altre informazioni, vedere TreeView_DeleteAllItems.

Fabbisogno