TreeView_DeleteAllItems Makro (commctrl.h)
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 |