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_ITEMEXPANDING 和 TVN_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 |