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

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

Синтаксис

void TreeView_DeleteItem(
   hwnd,
   hitem
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

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

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

None

Remarks

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

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

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

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

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

Требования

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