共用方式為

(docobj.h) IOleDocumentView：：SetRect 方法

  • 發行項

設定要啟動檢視區的矩形座標，或重設檢視區目前啟動檢視區的座標。

語法

HRESULT SetRect(
  [in] LPRECT prcView
);

參數

[in] prcView

RECT 結構的指標，包含檢視區的座標。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_FAIL
 作業失敗。

備註

對於單一檔介面 (SDI) 應用程式，檢視區是框架視窗的工作區減去為工具列、狀態列等配置的空間。 對於多文檔介面 (MDI) 視窗，檢視區是 MDI 文件視窗的工作區減去任何其他框架層級使用者介面元素。

來電者附註

呼叫 IOleDocumentView：：SetRect 或 IOleDocumentView：：SetRectComplex 是文件物件的一般啟用順序的一部分，通常會遵循呼叫 IOleDocumentView：：UIActivate ，並在 呼叫 IOleDocumentView：：Show 之前。

每當用來顯示檔物件的視窗重設大小時，容器應該呼叫 IOleDocumentView：：SetRect (或 IOleDocumentView：：SetRectComplex) ，以告知文件檢視物件將本身重設大小為新的視窗維度。

實作者的注意事項

檢視區的座標位於檢視視窗的座標內，這是透過 IOleWindow：：GetWindow 取得的。 檢視必須自行重設大小，以符合 傳入中國檢視的新座標。

這個方法是以 [input_sync] 屬性定義，這表示檢視對象在執行此方法時無法產生或建立另一個非input_sync RPC 呼叫。

文件檢視必須完全實作這個方法;E_NOTIMPL不是可接受的傳回值。

規格需求

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

另請參閱

IOleDocumentView