TVM_DELETEITEM messaggio

Rimuove un elemento e tutti i relativi elementi figlio da un controllo visualizzazione albero. È possibile inviare questo messaggio in modo esplicito o usando la macro TreeView_DeleteItem .

Parametri

wParam

Deve essere zero.

lParam

Handle HTREEITEM per l'elemento da eliminare. Se lParam è impostato su TVI_ROOT o su NULL, tutti gli elementi vengono eliminati. È anche possibile usare la macro TreeView_DeleteAllItems per eliminare tutti gli elementi.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario.

Commenti

Non è sicuro eliminare gli 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.

Requisiti

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