IOleWindow::GetWindow-Methode (oleidl.h)
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 |
|---|---|
|
Das Objekt ist fensterlos. |
|
Der angegebene fEnterMode-Wert ist ungültig. |
|
Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar. |
|
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 |