IOleInPlaceUIWindow：：SetBorderSpace 方法 (oleidl.h)

  • 项目

为 调用 IOleInPlaceUIWindow：：RequestBorderSpace 时请求的边框分配空间。

语法

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

参数

[in] pborderwidths

指向 BORDERWIDTHS 结构的指针，该结构包含所请求的工具宽度（以像素为单位）。 它可以为 NULL，表示对象不需要任何空间。

返回值

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

返回代码 说明
OLE_E_INVALIDRECT
 矩形不在 IOleInPlaceUIWindow：：GetBorder 返回的规范范围内。

注解

对象必须调用 IOleInPlaceUIWindow：：SetBorderSpace。 它可以执行以下任一操作：

  • 使用自己的工具栏，请求特定大小的边框空间。
  • 不使用工具栏，但强制容器删除其工具栏，方法是传递有效的 BORDERWIDTHS 结构，该结构只包含 pborderwidths 参数中的零。
  • 不使用工具栏，但允许就地容器通过将 NULL 作为 pborderwidths 参数来保留其工具栏。
此调用中使用的 BORDERWIDTHS 结构通常已在对 IOleInPlaceUIWindow：：RequestBorderSpace 的先前调用中传递，该调用必须已返回S_OK。

如果对象必须重新协商边框上的空间，则可以使用新的宽度再次调用 IOleInPlaceUIWindow：：SetBorderSpace 。 如果对 IOleInPlaceUIWindow：：SetBorderSpace 的调用失败，则对象可以通过调用 IOleInPlaceUIWindow：：GetBorder、 IOleInPlaceUIWindow：：RequestBorderSpace 和 IOleInPlaceUIWindow：：SetBorderSpace 对边框空间进行完全协商。

注意 在执行 IOleInPlaceUIWindow：：SetBorderSpace 时，不要调用 PeekMessage 或 GetMessage 函数或对话框。 这样做可能会导致系统死锁。 对可从 IOleInPlaceUIWindow：：SetBorderSpace 中调用哪些 OLE 接口方法和函数有进一步的限制。
 

要求

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

另请参阅

IOleInPlaceUIWindow

IOleInPlaceUIWindow：：GetBorder

IOleInPlaceUIWindow：：RequestBorderSpace