IConsole2::Expand-Methode (mmc.h)

  • Artikel

Mit der IConsole2::Expand-Methode kann das Snap-In ein Element im Bereichsbereich erweitern oder reduzieren.

Syntax

HRESULT Expand(
  [in] HSCOPEITEM hItem,
  [in] BOOL       bExpand
);

Parameter

[in] hItem

Ein Handle für das zu erweiternde Element.

[in] bExpand

Ein -Wert, der angibt, ob das Element erweitert oder reduziert werden soll. TRUE erweitert das Element. FALSE reduziert das Element.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Die IConsole2::Expand-Methode ist die programmgesteuerte Entsprechung des Benutzers, der auf das Plus- oder Minuszeichen klickt, um ein Element im Bereichsbereich zu erweitern oder zu reduzieren. Das heißt, diese Methode führt zu einer sichtbaren Erweiterung oder Zum Reduzieren eines Elements im Bereichsbereich. Beachten Sie, dass diese Methode die Auswahl im Bereichsbereich nicht ändert und sich nicht auf den Ergebnisbereich auswirkt.

Wenn diese Methode aufgerufen wird, erweitert oder reduziert MMC das durch hItem angegebene Element basierend auf dem für bExpand festgelegten Wert. MMC sendet dann eine Erweiterungsbenachrichtigung an das Snap-In jedes untergeordnete Element. MMC ruft dazu die IComponentData::Notify-Methode jedes untergeordneten Snap-Ins auf, wobei das Ereignis auf MMCN_EXPAND festgelegt ist, lpDataObject als Zeiger auf das Datenobjekt für hItem, arg basierend auf bExpand als TRUE oder FALSE und param als hItem festgelegt. Beachten Sie, dass hItem das HSCOPEITEM-Handle ist, das Sie in Ihrem Aufruf von IConsole2::Expand angegeben haben.

Die IConsole2::Expand-Methode gilt nur für eine bestimmte Ansicht. Dies bedeutet, dass es nur für die instance des IComponent-Objekts des Snap-Ins gilt, das dem Snap-In-Element entspricht, das in einem bestimmten MDI-Fenster (Multiple-Document Interface) innerhalb der Konsole angezeigt wird. Beachten Sie, dass jedes MDI-Fenster innerhalb der Konsole eine andere Ansicht darstellt und dass ein instance eines Snap-Ins innerhalb eines MDI-Fensters einem IComponent-Objekt für dieses Snap-In entspricht.

Daher sollte das Snap-In diese Methode nur für den IConsole2-Schnittstellenzeiger aufrufen, der einem IComponent-Objekt zugeordnet ist, d. h. einem IConsole2-Schnittstellenzeiger , der durch Aufrufen von QueryInterface auf dem IConsole-Schnittstellenzeiger abgerufen wird, der von IComponent::Initialize zurückgegeben wird.

Um die untergeordneten Elemente eines Elements im Namespace aufzulisten, ohne das Element sichtbar zu erweitern, sollte das Snap-In die IConsoleNameSpace2::Expand-Methode verwenden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h
DLL Mmcndmgr.dll

Weitere Informationen

IConsole2

IConsoleNameSpace2::Expand