IOleInPlaceActiveObject::ResizeBorder 方法 (oleidl.h)

提醒对象需要重设其边框空间的大小。

语法

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

参数

[in] prcBorder

指向包含新外部矩形的 RECT 结构的指针,对象可以在该矩形中请求其工具的边框空间。

[in] pUIWindow

指向边框已更改的框架或文档窗口对象的 IOleInPlaceUIWindow 接口指针的指针。

[in] fFrameWindow

如果框架窗口对象调用 IOleInPlaceActiveObject::ResizeBorder,则此参数为 TRUE;否则为 FALSE

返回值

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

返回代码 说明
E_INVALIDARG
指定的参数值无效。
E_OUTOFMEMORY
可用于操作的内存不足。
E_UNEXPECTED
发生了意外错误。

注解

调用方备注

当分配给对象的边框空间应更改时,顶级容器的文档或框架窗口对象调用 IOleInPlaceActiveObject::ResizeBorder。 由于活动就地对象没有通知 (框架级或文档级窗口) 更改了哪个窗口,因此必须将 IOleInPlaceActiveObject::ResizeBorder 的指针传递给窗口的 IOleInPlaceUIWindow 接口。

实施者说明

在大多数情况下,调整大小只需要扩大、缩小或缩放对象的框架装饰。 但是,对于更复杂的装饰,可能需要通过调用 IOleInPlaceUIWindow::SetBorderSpace 和 IOleInPlaceUIWindow::SetBorderSpace 重新协商边框空间。
注意 在执行 IOleInPlaceActiveObject::ResizeBorder 时,不要调用 PeekMessageGetMessage 函数或对话框。 这样做可能会导致系统死锁。 对可从 IOleInPlaceActiveObject::ResizeBorder 中调用哪些 OLE 接口方法和函数有进一步的限制。
 

要求

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

另请参阅

GetMessage

IOleInPlaceActiveObject

IOleInPlaceUIWindow::GetBorder

PeekMessage