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

void TreeView_DeleteItem(
   hwnd,
   hitem
);

Parameter

hwnd

Typ: HWND

Handle mit dem 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 makro TreeView_DeleteAllItems verwenden, um alle Elemente zu löschen.

Rückgabewert

Keine

Bemerkungen

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

Sobald 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 Elementbezeichnung 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 über die TVS_NOSCROLL-Format verfügt, werden später hinzugefügte Elemente möglicherweise nicht ordnungsgemäß angezeigt. Weitere Informationen finden Sie unter TreeView_DeleteAllItems.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h