macro TreeView_DeleteAllItems (commctrl.h)

Articolo
10/24/2024

Elimina tutti gli elementi da un controllo visualizzazione albero.

Sintassi

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

Valore restituito

Tipo: BOOL

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

Osservazioni

Dopo l'eliminazione di un elemento da un controllo visualizzazione albero, il relativo handle HTREEITEM non è valido e non può essere utilizzato.

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.

È anche possibile eliminare tutti gli elementi con la macro TreeView_DeleteItem o il messaggio di TVM_DELETEITEM impostando lParam su TVI_ROOT.

Se lo stile della finestra per un controllo visualizzazione albero contiene TVS_NOSCROLL e tutti gli elementi vengono eliminati, i nuovi elementi non vengono visualizzati fino a quando non vengono reimpostati gli stili della finestra. Il codice seguente mostra un modo per assicurarsi che gli elementi vengano sempre visualizzati.

DWORD styles = GetWindowLong(hwnd, GWL_STYLE);
TreeView_DeleteAllItems(hwnd);
SetWindowLong(hwnd, GWL_STYLE, styles);

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h

Condividi tramite