TVM_EXPAND消息

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

参数

wParam

操作标志。 此参数可能是以下一个或多个值:

含义
TVE_COLLAPSE
折叠列表。
TVE_COLLAPSERESET
折叠列表并删除子项。 重置TVIS_EXPANDEDONCE状态标志。 此标志必须与 TVE_COLLAPSE 标志一起使用。
TVE_EXPAND
展开列表。
TVE_EXPANDPARTIAL
版本 4.70。 部分展开列表。 在此状态下,子项可见,并显示父项的加号 (+) ,表示可以展开。 此标志必须与 TVE_EXPAND 标志结合使用。
TVE_TOGGLE
如果列表已展开,则折叠列表;如果已折叠,则将其展开。

lParam

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

返回值

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

备注

展开已展开的节点被视为成功的操作, SendMessage 将返回非零值。 如果节点已折叠,折叠节点将返回零;否则返回非零值。 尝试展开或折叠没有子级的节点被视为失败, SendMessage 返回零。

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

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

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h