IOleInPlaceSite::GetWindowCoNtext 方法 (oleidl.h)
可讓就地物件擷取形成視窗物件階層的視窗介面,以及物件就地啟用視窗應位於的父視窗位置。
語法
HRESULT GetWindowContext(
[out] IOleInPlaceFrame **ppFrame,
[out] IOleInPlaceUIWindow **ppDoc,
[out] LPRECT lprcPosRect,
[out] LPRECT lprcClipRect,
[in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);
參數
[out] ppFrame
IOleInPlaceFrame指標變數的指標,可接收框架的介面指標。 如果發生錯誤,實作必須將 ppFrame 設定為 Null。
[out] ppDoc
IOleInPlaceUIWindow指標變數的指標,可接收文件視窗的介面指標。 如果文件視窗與框架視窗相同, ppDoc 會設定為 Null。 在此情況下,物件只能使用 ppFrame 或框線交涉。 如果傳回錯誤,實作必須將 ppDoc 設定為 Null。
[out] lprcPosRect
矩形的 RECT 結構的指標,其中包含其父視窗之用戶端座標中就地物件的位置。 如果傳回錯誤,此參數必須設定為 Null。
[out] lprcClipRect
外部矩形的 RECT 結構的指標,其中包含就地物件的位置矩形 (lprcPosRect) 。 這個矩形相對於物件父視窗的工作區。 如果傳回錯誤,此參數必須設定為 Null。
[in, out] lpFrameInfo
容器要填入適當資料的 OLEINPLACEFRAMEINFO 結構的指標。 如果傳回錯誤,此參數必須設定為 Null。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | 描述 |
---|---|
|
提供的一或多個指標無效。 |
|
已發生未預期的錯誤。 |
備註
OLEINPLACEFRAMEINFO結構提供 OLE 所需的資料,以在物件就地使用時,將按鍵快速鍵分派至容器框架。
啟始物件時,它會從其容器呼叫 GetWindowCoNtext 。 容器會透過 OLEINPLACEFRAMEINFO 結構,將控制碼傳回至其就地快速鍵資料表。 呼叫GetWindowCoNtext之前,物件必須填入lpFrameInfo所指向的 cb 成員,以提供OLEINPLACEFRAMEINFO結構的大小。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |