IDockingWindow::ResizeBorderDW 方法 (shobjidl_core.h)

通知停靠窗口对象框架的边框空间已更改。 为了响应此方法, IDockingWindow 实现必须调用 SetBorderSpaceDW,即使不需要边框空间或不需要更改。

语法

HRESULT ResizeBorderDW(
  LPCRECT  prcBorder,
  IUnknown *punkToolbarSite,
  BOOL     fReserved
);

参数

prcBorder

类型: LPCRECT

指向包含框架可用边框空间的 RECT 结构的指针。

punkToolbarSite

类型: IUnknown*

指向站点的 IUnknown 接口的指针。 停靠窗口对象应为此接口调用 QueryInterface 方法,请求IID_IDockingWindowSite。 然后,停靠窗口对象使用该接口来协商其边框空间。 停靠窗口对象负责在不再需要此接口时释放该接口。

fReserved

类型: BOOL

保留。 此参数应始终为零。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

prcBorder 参数包含框架的整个可用边框空间。 停靠窗口对象应协商其边框空间,然后使用此信息来定位自身。

例如,如果停靠窗口对象需要边框空间顶部的 25 个像素,则应通过以下步骤协商此对象:

  1. 分配 BORDERWIDTHS 结构并将其 top 成员设置为 25。
  2. 调用 RequestBorderSpaceDW 以请求空间。
  3. 如果请求由 RequestBorderSpaceDW 批准,请调用 SetBorderSpaceDW 来分配空间。
然后,停靠窗口对象可以将其窗口定位在 prcBorder-left> 和 prcBorder-top>。 停靠窗口对象窗口的宽度是通过从 prcBorder-right 中减去 prcBorder-left>> 来确定的。 其高度包含在 BORDERWIDTHS 结构的顶部成员中。

要求

要求
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shlobj.h)
DLL Shell32.dll (版本 4.71 或更高版本)

另请参阅

IDeskBand

IDockingWindow

IDockingWindowFrame

IDockingWindowSite