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 通知，则展开操作可能会失败。

要求