IOleInPlaceSite::GetWindowContext-Methode (oleidl.h)
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 |
|---|---|
|
Mindestens einer der angegebenen Zeiger ist ungültig. |
|
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 |