TreeView_DeleteAllItems Makro (commctrl.h)

Artikel
08/22/2023

Löscht alle Elemente aus einem Strukturansichtssteuerelement.

Syntax

void TreeView_DeleteAllItems(
   hwnd
);

Parameter

hwnd

Typ: HWND

Handle für das Strukturansichtssteuerelement.

Rückgabewert

Keine

Bemerkungen

Sobald ein Element aus einem Strukturansichtssteuerelement gelöscht wurde, ist das HTREEITEM-Handle ungültig und kann nicht mehr 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.

Sie können auch alle Elemente mit dem TreeView_DeleteItem-Makro oder der TVM_DELETEITEM Nachricht löschen, indem Sie lParam auf TVI_ROOT festlegen.

Wenn der Fensterstil für ein Strukturansichtssteuerelement TVS_NOSCROLL enthält und alle Elemente gelöscht werden, werden neue Elemente erst angezeigt, wenn die Fensterstile zurückgesetzt werden. Der folgende Code zeigt eine Möglichkeit, um sicherzustellen, dass Elemente immer angezeigt werden.

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

Anforderungen

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