TreeView_DeleteAllItems 宏 (commctrl.h)

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

语法

void TreeView_DeleteAllItems(
   hwnd
);

参数

hwnd

类型: HWND

树视图控件的句柄。

返回值

备注

从树视图控件中删除项后,其 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 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h