IOleInPlaceUIWindow::GetBorder 方法 (oleidl.h)

在对象就地处于活动状态时检索工具栏和控件的外部矩形。

语法

HRESULT GetBorder(
  [out] LPRECT lprectBorder
);

参数

[out] lprectBorder

指向要返回外部矩形的 RECT 结构的指针。 结构的坐标相对于接口所表示的窗口。

返回值

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

返回代码 说明
INPLACE_E_NOTOOLSPACE
对象无法在此窗口对象中安装工具栏。
E_OUTOFMEMORY
可用于此操作的内存不足。
E_UNEXPECTED
发生意外错误。

注解

给调用方的说明

在文档或框架窗口对象上调用 IOleInPlaceUIWindow::GetBorder 函数时,返回相对于窗口 (外部矩形) 对象可以放置工具栏或类似控件。

如果对象要安装这些工具,则应使用 IOleInPlaceUIWindow::RequestBorderSpace 协商此矩形中的工具的空间,然后调用 IOleInPlaceUIWindow::SetBorderSpace 来分配此空间。

注意 在执行 IOleInPlaceUIWindow::GetBorder 时,不要调用 PeekMessageGetMessage 函数或对话框。 这样做可能会导致系统死锁。 从 GetBorder 中调用 OLE 接口方法和函数还有进一步的限制。
 

要求

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

另请参阅

IOleInPlaceUIWindow

IOleInPlaceUIWindow::RequestBorderSpace

IOleInPlaceUIWindow::SetBorderSpace