IOleDocumentView::SetRect 方法 (docobj.h)
设置要在其中激活视图的视口的矩形坐标,或重置当前激活视图的视区坐标。
语法
HRESULT SetRect(
[in] LPRECT prcView
);
参数
[in] prcView
指向包含视区坐标的 RECT 结构的指针。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
此操作失败。 |
注解
对于 SDI) 应用程序的单个文档界面 (,视区是框架窗口的工作区减去为工具栏、状态栏等分配的空间。 对于 MDI) 窗口 (多文档界面,视区是 MDI 文档窗口的工作区减去任何其他框架级用户界面元素。
调用方备注
调用 IOleDocumentView::SetRect 或 IOleDocumentView::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 |