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 |
---|---|
|
作業失敗。 |
|
擁有此檢視的檔物件不支援複雜的矩形。 |
備註
檢視支援活頁簿隱喻的框架,其中單一檔包含多個工作表或頁面,通常會呼叫此方法來設定所有工作表或頁面通用使用的座標。
來電者的附註
呼叫 IOleDocumentView::SetRectComplex 是支援複雜矩形之文件物件的一般啟用順序的一部分,通常遵循對 IOleDocumentView::UIActivate 和呼叫 IOleDocumentView::Show 之前的呼叫。每當用來顯示檔物件的視窗重設大小時,容器應該呼叫 IOleDocumentView::SetRectComplex 或 IOleDocumentView::SetRect ,告知檢視物件將本身調整為新的窗口維度。
實作者的注意事項
支援複雜矩形的文件物件會以 DOCMISC_SUPPORTCOMPLEXRECTANGLES標示自己,如 DOCMISC 和 IOleDocument::GetDocMiscStatus 中所述。 不支援此方法的檔物件可以傳回E_NOTIMPL。收到此方法的呼叫時,檢視應該重設大小以符合中國View 中指定的座標,並將其滾動條和大小方塊調整為 中國HScroll、 中國VScroll 和 中國SizeBox 中所述的區域。
此方法是使用 [input_sync] 屬性來定義,這表示實作對象在執行此方法時,無法產生或建立另一個非input_sync RPC 呼叫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | docobj.h |