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 |