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。 其他可能的返回值包括以下内容。

返回代码 说明
E_FAIL
此操作失败。
E_NOTIMPL
拥有此视图的文档对象不支持复杂矩形。

注解

支持工作簿比喻的视图框架(其中单个文档包含多个工作表或页面)通常调用此方法来设置所有工作表或页面通用的坐标。

给调用方的说明

调用 IOleDocumentView::SetRectComplex 是支持复杂矩形的文档对象的正常激活序列的一部分,通常先调用 IOleDocumentView::UIActivate ,再调用 IOleDocumentView::Show

每当调整用于显示文档对象的窗口的大小时,容器都应调用 IOleDocumentView::SetRectComplexIOleDocumentView::SetRect ,以告知视图对象将自身大小调整为新窗口尺寸。

实施者说明

支持复杂矩形的文档对象使用 DOCMISC_SUPPORTCOMPLEXRECTANGLES标记自己,如 DOCMISCIOleDocument::GetDocMiscStatus 中所述。 不支持此方法的文档对象可以返回E_NOTIMPL。

收到对此方法的调用后,视图应调整自身大小以适应在 prcView 中指定的坐标,并将其滚动条和大小框拟合到 prcHScrollprcVScrollprcSizeBox 中描述的区域。

此方法使用 [input_sync] 属性定义,这意味着实现对象在执行此方法时无法生成或发出另一个非input_sync RPC 调用。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 docobj.h

另请参阅

IOleDocument::GetDocMiscStatus

IOleDocumentView