Skip to content

Latest commit

 

History

History
112 lines (76 loc) · 5.21 KB

nf-shobjidl_core-idockingwindow-resizeborderdw.md

File metadata and controls

112 lines (76 loc) · 5.21 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:shobjidl_core.IDockingWindow.ResizeBorderDW
IDockingWindow::ResizeBorderDW (shobjidl_core.h)
Notifies the docking window object that the frame's border space has changed. In response to this method, the IDockingWindow implementation must call SetBorderSpaceDW, even if no border space is required or a change is not necessary.
IDockingWindow interface [Windows Shell]
ResizeBorderDW method
IDockingWindow.ResizeBorderDW
IDockingWindow::ResizeBorderDW
ResizeBorderDW
ResizeBorderDW method [Windows Shell]
ResizeBorderDW method [Windows Shell]
IDockingWindow interface
_win32_IDockingWindow_ResizeBorderDW
shell.IDockingWindow_ResizeBorderDW
shobjidl_core/IDockingWindow::ResizeBorderDW
shell\IDockingWindow_ResizeBorderDW.htm
shell
de61badd-0794-484c-921f-4e72e881579c
12/05/2018
IDockingWindow interface [Windows Shell],ResizeBorderDW method, IDockingWindow.ResizeBorderDW, IDockingWindow::ResizeBorderDW, ResizeBorderDW, ResizeBorderDW method [Windows Shell], ResizeBorderDW method [Windows Shell],IDockingWindow interface, _win32_IDockingWindow_ResizeBorderDW, shell.IDockingWindow_ResizeBorderDW, shobjidl_core/IDockingWindow::ResizeBorderDW
shobjidl_core.h
Shlobj.h
Windows
Windows 2000 Professional, Windows XP [desktop apps only]
Windows 2000 Server [desktop apps only]
Shell32.dll (version 4.71 or later)
Windows
19H1
IDockingWindow::ResizeBorderDW
shobjidl_core/IDockingWindow::ResizeBorderDW
c++
APIRef
kbSyntax
COM
Shell32.dll
IDockingWindow.ResizeBorderDW

IDockingWindow::ResizeBorderDW

-description

Notifies the docking window object that the frame's border space has changed. In response to this method, the IDockingWindow implementation must call SetBorderSpaceDW, even if no border space is required or a change is not necessary.

-parameters

-param prcBorder

Type: LPCRECT

Pointer to a RECT structure that contains the frame's available border space.

-param punkToolbarSite

Type: IUnknown*

Pointer to the site's IUnknown interface. The docking window object should call the QueryInterface method for this interface, requesting IID_IDockingWindowSite. The docking window object then uses that interface to negotiate its border space. It is the docking window object's responsibility to release this interface when it is no longer needed.

-param fReserved

Type: BOOL

Reserved. This parameter should always be zero.

-returns

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

The prcBorder parameter contains the frame's entire available border space. The docking window object should negotiate its border space and then use this information to position itself.

For example, if the docking window object requires 25 pixels at the top of the border space, it should negotiate for this through the following steps:

  1. Allocate a BORDERWIDTHS structure and set its top member to 25.
  2. Call RequestBorderSpaceDW to request the space.
  3. If the request is approved by RequestBorderSpaceDW, call SetBorderSpaceDW to allocate the space.
            The docking window object can then position its window at prcBorder-&gt;left and prcBorder-&gt;top. The width of the docking window object's window is determined by subtracting prcBorder-&gt;left from prcBorder-&gt;right. Its height is contained in the <b>top</b> member of the <a href="/previous-versions/windows/desktop/legacy/cc136564(v=vs.85)">BORDERWIDTHS</a> structure.

-see-also

IDeskBand

IDockingWindow

IDockingWindowFrame

IDockingWindowSite