TreeView_DeleteItem宏（commctrl.h）

从树视图控件中删除项及其所有子项。还可以显式发送 TVM_DELETEITEM 消息。

语法

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

hwnd

类型：HWND

树视图控件的句柄。

hitem

类型：HTREEITEM

要删除的项 句柄。如果命中设置为TVI_ROOT，则会从树视图控件中删除所有项。还可以使用 TreeView_DeleteAllItems 宏删除所有项。

类型：BOOL

如果成功，则返回 TRUE;否则返回 FALSE。

在响应通知（如 TVN_SELCHANGING）时删除项目是不安全的。

删除项后，其句柄无效，不能使用。

删除每个项时，父窗口会收到 TVN_DELETEITEM 通知代码。

如果正在编辑项标签，则取消编辑操作，并且父窗口会收到 TVN_ENDLABELEDIT 通知代码。

如果删除具有 TVS_NOSCROLL 样式的树视图控件中的所有项，则随后添加的项目可能无法正确显示。有关详细信息，请参阅 TreeView_DeleteAllItems。