IDockingWindow::ResizeBorderDWIDockingWindow::ResizeBorderDW*
*Contents  *Index  *Topic Contents
*Previous Topic: IDockingWindow::CloseDW
*Next Topic: IDockingWindow::ShowDW

IDockingWindow::ResizeBorderDW


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

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

prcBorder
Address of a RECT structure that contains the frame's available border space.
punkToolbarSite
Address of the site's IUnknown interface. The docking window object should call the QueryInterface method for this interface, requesting IID_IShellToolbarSite, and use 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.
fReserved
Reserved for future use. This parameter should always be zero.

The prcBorder parameter will contain 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 by allocating a BORDERWIDTHS structure, setting the top member to 25, calling IDockingWindowSite::RequestBorderSpaceDW, and then calling IDockingWindowSite::SetBorderSpaceDW. The docking window object can then position its window at prcBorder->left and prcBorder->top. The width of the docking window object's window is determined from prcBorder->right - prcBorder->left, and its height is contained in the top member of the BORDERWIDTHS structure.

Version 4.71

See also IDockingWindow, IDockingWindowFrame, IDockingWindowSite

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.