макрос TreeView_DeleteAllItems (commctrl.h)

Статья
08/22/2023

Удаляет все элементы из элемента управления в виде дерева.

Синтаксис

void TreeView_DeleteAllItems(
   hwnd
);

Параметры

hwnd

Тип: HWND

Дескриптор для элемента управления представлением в виде дерева.

Возвращаемое значение

None

Remarks

После удаления элемента из элемента управления представлением в виде дерева его дескриптор HTREEITEM становится недопустимым и его нельзя использовать.

Родительское окно получает код уведомления TVN_DELETEITEM при удалении каждого элемента.

Если метка элемента редактируется, операция редактирования отменяется, а родительское окно получает код уведомления TVN_ENDLABELEDIT .

Вы также можете удалить все элементы с помощью макроса TreeView_DeleteItem или сообщения TVM_DELETEITEM , задав для lParam значение TVI_ROOT.

Если стиль окна для элемента управления представлением в виде дерева содержит TVS_NOSCROLL и все элементы удаляются, новые элементы не отображаются до тех пор, пока стили окна не будут сброшены. В следующем коде показан один из способов обеспечения постоянного отображения элементов.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h