IOleDocumentView::SetRect 方法 (docobj.h)

设置要在其中激活视图的视口的矩形坐标,或重置当前激活视图的视区坐标。

语法

HRESULT SetRect(
  [in] LPRECT prcView
);

参数

[in] prcView

指向包含视区坐标的 RECT 结构的指针。

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
E_FAIL
此操作失败。

注解

对于 SDI) 应用程序的单个文档界面 (,视区是框架窗口的工作区减去为工具栏、状态栏等分配的空间。 对于 MDI) 窗口 (多文档界面,视区是 MDI 文档窗口的工作区减去任何其他框架级用户界面元素。

调用方备注

调用 IOleDocumentView::SetRectIOleDocumentView::SetRectComplex 是文档对象的正常激活序列的一部分,通常先调用 IOleDocumentView::UIActivate ,再调用 IOleDocumentView::Show

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

实施者说明

视区坐标位于视图窗口的坐标范围内,该坐标通过 IOleWindow::GetWindow 获取。 视图必须调整自身大小以适应在 prcView 中传递的新坐标。

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

文档视图必须完全实现此方法;E_NOTIMPL不是可接受的返回值。

要求

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

另请参阅

IOleDocumentView