TreeView_DeleteItem Makro (commctrl.h)

Entfernt ein Element und alle untergeordneten Elemente aus einem Strukturansichtssteuerelement. Sie können die TVM_DELETEITEM Nachricht auch explizit senden.

Syntax

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM-

HTREEITEM- handle für das zu löschende Element. Wenn Hitem- auf TVI_ROOT festgelegt ist, werden alle Elemente aus dem Strukturansichtssteuerelement gelöscht. Sie können auch das TreeView_DeleteAllItems Makro verwenden, um alle Elemente zu löschen.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Es ist nicht sicher, Elemente als Reaktion auf eine Benachrichtigung wie TVN_SELCHANGINGzu löschen.

Nachdem ein Element gelöscht wurde, ist sein Handle ungültig und kann nicht verwendet werden.

Das übergeordnete Fenster empfängt einen TVN_DELETEITEM Benachrichtigungscode, wenn jedes Element entfernt wird.

Wenn die Elementbeschriftung bearbeitet wird, wird der Bearbeitungsvorgang abgebrochen, und das übergeordnete Fenster empfängt den TVN_ENDLABELEDIT Benachrichtigungscode.

Wenn Sie alle Elemente in einem Strukturansichtssteuerelement löschen, das die TVS_NOSCROLL Formatvorlage aufweist, werden die anschließend hinzugefügten Elemente möglicherweise nicht ordnungsgemäß angezeigt. Weitere Informationen finden Sie unter TreeView_DeleteAllItems.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h