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

Статья
10/24/2024

Удаляет элемент и все его дочерние элементы из элемента управления "Представление дерева". Вы также можете явно отправить сообщение TVM_DELETEITEM.

Синтаксис

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

HTREEITEM дескриптор для удаления элемента. Если hitem установлено значение TVI_ROOT, все элементы удаляются из элемента управления "Представление дерева". Вы также можете использовать макрос TreeView_DeleteAllItems для удаления всех элементов.

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

Тип: BOOL

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

Замечания

Небезопасно удалять элементы в ответ на уведомление, например TVN_SELCHANGING.

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

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

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

Если удалить все элементы в элементе управления "Дерево", который имеет стиль TVS_NOSCROLL, элементы впоследствии могут не отображаться должным образом. Дополнительные сведения см. в TreeView_DeleteAllItems.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

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