TreeView_DeleteItem宏 (commctrl.h)

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

语法

void TreeView_DeleteItem(
   hwnd,
   hitem
);

参数

hwnd

类型: HWND

树视图控件的句柄。

hitem

类型: HTREEITEM

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

返回值

备注

删除项以响应 TVN_SELCHANGING等通知是不安全的。

删除项后,其句柄无效,无法使用。

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

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

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

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h