IOleInPlaceSite::GetWindowContext-Methode (oleidl.h)

Artikel
08/25/2023

Ermöglicht es einem direkten Objekt, die Fensterschnittstellen abzurufen, die die Fensterobjekthierarchie bilden, und die Position im übergeordneten Fenster, an der sich das direkte Aktivierungsfenster des Objekts befinden soll.

Syntax

HRESULT GetWindowContext(
  [out]     IOleInPlaceFrame      **ppFrame,
  [out]     IOleInPlaceUIWindow   **ppDoc,
  [out]     LPRECT                lprcPosRect,
  [out]     LPRECT                lprcClipRect,
  [in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);

Parameter

[out] ppFrame

Ein Zeiger auf eine IOleInPlaceFrame-Zeigervariable , die den Schnittstellenzeiger auf den Frame empfängt. Wenn ein Fehler auftritt, muss die Implementierung ppFrame auf NULL festlegen.

[out] ppDoc

Ein Zeiger auf eine IOleInPlaceUIWindow-Zeigervariable , die den Schnittstellenzeiger auf das Dokumentfenster empfängt. Wenn das Dokumentfenster mit dem Rahmenfenster identisch ist, wird ppDoc auf NULL festgelegt. In diesem Fall kann das Objekt nur ppFrame - oder Border-Aushandlung verwenden. Wenn ein Fehler zurückgegeben wird, muss die Implementierung ppDoc auf NULL festlegen.

[out] lprcPosRect

Ein Zeiger auf eine RECT-Struktur für das Rechteck, das die Position des direkten Objekts in den Clientkoordinaten des übergeordneten Fensters enthält. Wenn ein Fehler zurückgegeben wird, muss dieser Parameter auf NULL festgelegt werden.

[out] lprcClipRect

Ein Zeiger auf eine RECT-Struktur für das äußere Rechteck, das das Positionsrechteck des in-situ-Objekts (lprcPosRect) enthält. Dieses Rechteck ist relativ zum Clientbereich des übergeordneten Fensters des Objekts. Wenn ein Fehler zurückgegeben wird, muss dieser Parameter auf NULL festgelegt werden.

[in, out] lpFrameInfo

Ein Zeiger auf eine OLEINPLACEFRAMEINFO-Struktur , die der Container mit den entsprechenden Daten ausfüllen soll. Wenn ein Fehler zurückgegeben wird, muss dieser Parameter auf NULL festgelegt werden.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens einer der angegebenen Zeiger ist ungültig.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Die OLEINPLACEFRAMEINFO-Struktur stellt Daten bereit, die ole benötigt, um Tastenkombinationen an einen Containerframe zu senden, während ein Objekt aktiv ist.

Wenn ein Objekt aktiviert wird, ruft es GetWindowContext aus seinem Container auf. Der Container gibt das Handle über die OLEINPLACEFRAMEINFO-Struktur an seine direkte Zugriffstastentabelle zurück. Vor dem Aufrufen von GetWindowContext muss das -Objekt die Größe der OLEINPLACEFRAMEINFO-Struktur angeben, indem es den cb-Member ausfüllt, auf den lpFrameInfo verweist.

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

IOleInPlaceSite