IOleDocumentView::SetRectComplex 方法 (docobj.h)

設定檢視區、滾動條和大小方塊的矩形座標。

語法

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

參數

[in] prcView

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

[in] prcHScroll

RECT 結構的指標,其中包含水平滾動條的座標。

[in] prcVScroll

RECT 結構的指標,其中包含垂直滾動條的座標。

[in] prcSizeBox

RECT 結構的指標,其中包含大小方塊的座標。

傳回值

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

傳回碼 Description
E_FAIL
作業失敗。
E_NOTIMPL
擁有此檢視的檔物件不支援複雜的矩形。

備註

檢視支援活頁簿隱喻的框架,其中單一檔包含多個工作表或頁面,通常會呼叫此方法來設定所有工作表或頁面通用使用的座標。

來電者的附註

呼叫 IOleDocumentView::SetRectComplex 是支援複雜矩形之文件物件的一般啟用順序的一部分,通常遵循對 IOleDocumentView::UIActivate 和呼叫 IOleDocumentView::Show 之前的呼叫。

每當用來顯示檔物件的視窗重設大小時,容器應該呼叫 IOleDocumentView::SetRectComplexIOleDocumentView::SetRect ,告知檢視物件將本身調整為新的窗口維度。

實作者的注意事項

支援複雜矩形的文件物件會以 DOCMISC_SUPPORTCOMPLEXRECTANGLES標示自己,如 DOCMISCIOleDocument::GetDocMiscStatus 中所述。 不支援此方法的檔物件可以傳回E_NOTIMPL。

收到此方法的呼叫時,檢視應該重設大小以符合中國View 中指定的座標,並將其滾動條和大小方塊調整為 中國HScroll中國VScroll中國SizeBox 中所述的區域。

此方法是使用 [input_sync] 屬性來定義,這表示實作對象在執行此方法時,無法產生或建立另一個非input_sync RPC 呼叫。

規格需求

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

另請參閱

IOleDocument::GetDocMiscStatus

IOleDocumentView