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

Статья
10/24/2024

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

Синтаксис

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Параметры

hwnd

Тип: HWND

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

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

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

После удаления элемента из элемента управления "Дерево" его 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 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

Поделиться через