TreeView_DeleteAllItems 宏 (commctrl.h)

从树视图控件中删除所有项。

语法

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

参数

hwnd

类型:HWND

树视图控件的句柄。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

从树视图控件中删除项后,其 HTREEITEM 句柄无效且无法使用。

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

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

还可以通过将 lParam 设置为TVI_ROOT来删除具有 TreeView_DeleteItem 宏或 TVM_DELETEITEM 消息的所有项。

如果树视图控件的窗口样式包含TVS_NOSCROLL并删除所有项,则在重置窗口样式之前不会显示新项。 以下代码显示了确保始终显示项的一种方法。

DWORD styles = GetWindowLong(hwnd, GWL_STYLE);
TreeView_DeleteAllItems(hwnd);
SetWindowLong(hwnd, GWL_STYLE, styles);

要求

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