TreeView_DeleteAllItems Makro (commctrl.h)

Artikel
10/24/2024

Löscht alle Elemente aus einem Strukturansicht-Steuerelement.

Syntax

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Nachdem ein Element aus einem Strukturansichtssteuerelement gelöscht wurde, ist dessen HTREEITEM- 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.

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 das Fensterformat für ein Strukturansichtssteuerelement TVS_NOSCROLL enthält und alle Elemente gelöscht werden, werden neue Elemente erst angezeigt, wenn die Fensterformatvorlagen 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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Freigeben über