сообщение TVM_DELETEITEM

Удаляет элемент и все его дочерние элементы из элемента управления в виде дерева. Это сообщение можно отправить явно или с помощью макроса TreeView_DeleteItem .

Параметры

wParam

Должен равняться нулю.

lParam

Дескриптор HTREEITEM для удаляемого элемента. Если параметру lParam присвоено значение TVI_ROOT или ЗНАЧЕНИЕ NULL, все элементы удаляются. Вы также можете использовать макрос TreeView_DeleteAllItems для удаления всех элементов.

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

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

Комментарии

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

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

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

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

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

Требования

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