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。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
此操作失败。 |
|
拥有此视图的文档对象不支持复杂矩形。 |
注解
支持工作簿比喻的视图框架(其中单个文档包含多个工作表或页面)通常调用此方法来设置所有工作表或页面通用的坐标。
给调用方的说明
调用 IOleDocumentView::SetRectComplex 是支持复杂矩形的文档对象的正常激活序列的一部分,通常先调用 IOleDocumentView::UIActivate ,再调用 IOleDocumentView::Show。每当调整用于显示文档对象的窗口的大小时,容器都应调用 IOleDocumentView::SetRectComplex 或 IOleDocumentView::SetRect ,以告知视图对象将自身大小调整为新窗口尺寸。
实施者说明
支持复杂矩形的文档对象使用 DOCMISC_SUPPORTCOMPLEXRECTANGLES标记自己,如 DOCMISC 和 IOleDocument::GetDocMiscStatus 中所述。 不支持此方法的文档对象可以返回E_NOTIMPL。收到对此方法的调用后,视图应调整自身大小以适应在 prcView 中指定的坐标,并将其滚动条和大小框拟合到 prcHScroll、 prcVScroll 和 prcSizeBox 中描述的区域。
此方法使用 [input_sync] 属性定义,这意味着实现对象在执行此方法时无法生成或发出另一个非input_sync RPC 调用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | docobj.h |