共用方式為


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。 其他可能的傳回值包括下列專案。

傳回碼 描述
E_INVALIDARG
提供的一或多個指標無效。
E_UNEXPECTED
已發生未預期的錯誤。

備註

OLEINPLACEFRAMEINFO結構提供 OLE 所需的資料,以在物件就地使用時,將按鍵快速鍵分派至容器框架。

啟始物件時,它會從其容器呼叫 GetWindowCoNtext 。 容器會透過 OLEINPLACEFRAMEINFO 結構,將控制碼傳回至其就地快速鍵資料表。 呼叫GetWindowCoNtext之前,物件必須填入lpFrameInfo所指向的 cb 成員,以提供OLEINPLACEFRAMEINFO結構的大小。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

IOleInPlaceSite