IOleWindow::GetWindow-Methode (oleidl.h)

  • Artikel

Ruft ein Handle für eines der Fenster ab, die an der direkten Aktivierung teilnehmen (Frame-, Dokument-, übergeordnetes oder direktes Objektfenster).

Syntax

HRESULT GetWindow(
  [out] HWND *phwnd
);

Parameter

[out] phwnd

Ein Zeiger auf eine Variable, die das Fensterhandle empfängt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_FAIL
 Das Objekt ist fensterlos.
E_INVALIDARG
 Der angegebene fEnterMode-Wert ist ungültig.
E_OUTOFMEMORY
 Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Fünf Fenstertypen umfassen die Fensterhierarchie. Wenn ein Objekt aktiv ist, hat es Zugriff auf einige oder alle dieser Fenster.

Fenster BESCHREIBUNG
Frame Das äußerste Standard Fenster, in dem sich das menü Standard der Containeranwendung befindet.
Dokument Das Fenster, in dem das zusammengesetzte Dokument angezeigt wird, das das eingebettete Objekt für den Benutzer enthält.
Bereich Der Unterfenster des Dokumentfensters, das die Ansicht des Objekts enthält. Gilt nur für Anwendungen mit Fenstern mit geteilten Bereichen.
Parent Das Containerfenster, das die Ansicht dieses Objekts enthält. Die Objektanwendung installiert ihr Fenster als untergeordnetes Element dieses Fensters.
Direkt Das Fenster, das das aktive direkte Objekt enthält. Die Objektanwendung erstellt dieses Fenster und installiert es als untergeordnetes Element des Schraffurfensters, das ein untergeordnetes Element des übergeordneten Fensters des Containers ist.
 

Jeder Fenstertyp hat in der Architektur der direkten Aktivierung eine andere Rolle. Es ist jedoch nicht erforderlich, für jeden Typ ein separates physisches Fenster zu verwenden. Viele Containeranwendungen verwenden dasselbe Fenster für ihre Rahmen-, Dokument-, Bereichs- und übergeordneten Fenster.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

IOleWindow