TVM_DELETEITEM Nachricht

Entfernt ein Element und alle untergeordneten Elemente aus einem Strukturansichtssteuerelement. Sie können diese Nachricht explizit oder mithilfe des makros TreeView_DeleteItem senden.

Parameter

wParam

Muss Null sein.

lParam

HTREEITEM-Handle für das zu löschende Element. Wenn lParam auf TVI_ROOT oder AUF NULL festgelegt ist, werden alle Elemente gelöscht. Sie können auch das makro TreeView_DeleteAllItems verwenden, um alle Elemente zu löschen.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h