IConsole2::Expand 方法 (mmc.h)
IConsole2::Expand 方法使管理单元能够展开或折叠作用域窗格中的项。
语法
HRESULT Expand(
[in] HSCOPEITEM hItem,
[in] BOOL bExpand
);
parameters
[in] hItem
要展开的项的句柄。
[in] bExpand
一个 值,该值指定是展开还是折叠项。 如果为 TRUE ,则展开该项。 FALSE 折叠项。
返回值
此方法可以返回其中一个值。
注解
IConsole2::Expand 方法是用户单击加号或减号以展开或折叠作用域窗格中的项的编程等效方法。 也就是说,此方法会导致范围窗格中项的可见展开或折叠。 请注意,此方法不会更改范围窗格中的选择,也不会影响结果窗格。
调用此方法时,MMC 根据为 bExpand 设置的值展开或折叠 hItem 指定的项。 然后,MMC 会向每个子项的管理单元发送展开通知。 MMC 通过调用每个子管理单元的 IComponentData::Notify 方法来实现此目的,其中事件设置为 MMCN_EXPAND,将 lpDataObject 设置为指向 hItem 的数据对象的指针,根据 bExpand 将 arg 设置为 TRUE 或 FALSE,并将参数设置为 hItem。 请注意,hItem 是在调用 IConsole2::Expand 时指定的 HSCOPEITEM 句柄。
IConsole2::Expand 方法仅适用于特定视图。 这意味着,它仅适用于管理单元的 IComponent 对象的实例,该对象对应于控制台中 MDI) 窗口中显示的特定多文档界面 (管理单元项。 请注意,控制台中的每个 MDI 窗口表示不同的视图,并且 MDI 窗口中管理单元的实例对应于该管理单元的 IComponent 对象。
因此,管理单元应仅在与 IComponent 对象关联的 IConsole2 接口指针上调用此方法,即,通过在 IComponent::Initialize 返回的 IConsole 接口指针上调用 QueryInterface 检索到的 IConsole2 接口指针。
若要枚举命名空间中项的子项而不明显展开该项,管理单元应使用 IConsoleNameSpace2::Expand 方法。
要求
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | mmc.h |
DLL | Mmcndmgr.dll |