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