Метод IConsole2::Expand (mmc.h)
Метод IConsole2::Expand позволяет оснастке развернуть или свернуть элемент в области область.
Синтаксис
HRESULT Expand(
[in] HSCOPEITEM hItem,
[in] BOOL bExpand
);
Параметры
[in] hItem
Дескриптор разворачиваемого элемента.
[in] bExpand
Значение типа , указывающее, следует ли развернуть или свернуть элемент. Значение TRUE разворачивает элемент. False сворачивает элемент.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Метод IConsole2::Expand является программным эквивалентом, который пользователь щелкает знак "плюс" или "минус", чтобы развернуть или свернуть элемент в области область. То есть этот метод вызывает видимое расширение или сворачивание элемента в области область. Имейте в виду, что этот метод не изменяет выбор в области область и не влияет на панель результатов.
При вызове этого метода MMC разворачивает или сворачивает элемент, указанный в hItem , на основе значения, заданного для параметра bExpand. Затем MMC отправляет уведомление о развертывании в оснастку каждого дочернего элемента. MMC делает это путем вызова метода IComponentData::Notify каждой дочерней оснастки с событием MMCN_EXPAND, lpDataObject — в качестве указателя на объект данных для hItem, аргумент arg — true или FALSE на основе bExpand, а параметр — как hItem. Имейте в виду, что hItem — это дескриптор HSCOPEITEM , указанный в вызове IConsole2::Expand.
Метод IConsole2::Expand применяется только к определенному представлению. Это означает, что он применяется только к экземпляру объекта IComponent оснастки, соответствующего элементу оснастки, который отображается в определенном окне многодокументного интерфейса (MDI) в консоли. Имейте в виду, что каждое окно MDI в консоли представляет отдельное представление и что экземпляр оснастки в окне MDI соответствует объекту IComponent для этой оснастки.
Поэтому оснастка должна вызывать этот метод только для указателя интерфейса IConsole2 , связанного с объектом IComponent , то есть указателя интерфейса IConsole2 , полученного путем вызова QueryInterface в указателе интерфейса IConsole , возвращаемом методом IComponent::Initialize.
Чтобы перечислить дочерние элементы элемента в пространстве имен без видимого расширения элемента, оснастка должна использовать метод IConsoleNameSpace2::Expand .
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |
| DLL | Mmcndmgr.dll |