TreeView_Expand宏 (commctrl.h)

TreeView_Expand 宏展开或折叠与指定父项关联的子项列表(如果有)。 可以使用此宏或显式发送 TVM_EXPAND 消息。

语法

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

参数

hwnd

类型:HWND

树视图控件的句柄。

hitem

类型:HTREEITEM

将展开或折叠的父项的句柄。

code

类型:UINT

操作标志。 有关可能值的列表,请参阅 TVM_EXPAND中的 wParam 参数的说明。

返回值

类型:BOOL

如果操作成功,则返回非零,否则返回零。

言论

展开已展开的节点或折叠已折叠的节点被视为成功的操作,宏返回非零值。 尝试展开或折叠没有子级的节点被视为失败,返回值为零。

当项首次由 TVM_EXPAND 消息展开时,该操作将生成 TVN_ITEMEXPANDINGTVN_ITEMEXPANDED 通知代码,并设置项目的 TVIS_EXPANDEDONCE 状态标志。 只要此状态标志保持设置,后续 TVM_EXPAND 消息不会生成TVN_ITEMEXPANDING或TVN_ITEMEXPANDED通知。 若要重置 TVIS_EXPANDEDONCE 状态标志,必须发送 TVM_EXPAND 消息,并设置TVE_COLLAPSE和TVE_COLLAPSERESET标志。 尝试显式设置 TVIS_EXPANDEDONCE 将导致不可预知的行为。

如果树视图控件的所有者拒绝操作以响应 TVN_ITEMEXPANDING 通知,则展开操作可能会失败。

要求

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