IOleInPlaceActiveObject::ResizeBorder

Alerts the object that it needs to resize its border space.

HRESULT ResizeBorder(

LPCRECT prcBorder,	//New outer rectangle for border space
IOleInPlaceUIWindow pUIWindow,	//Frame or document window border change
BOOL fFrameWindow	//Frame window object is or isn't calling ResizeBorder
);

Parameters
prcBorder
[in] Points to a RECT structure containing the new outer rectangle within which the object can request border space for its tools.

pUIWindow
[in] Points to the frame or document window object whose border has changed.

fFrameWindow
[in] Specifies TRUE if the frame window object is calling ResizeBorder; otherwise, FALSE.

Return Values
S_OK

The method alerted the object successfully.

E_INVALIDARG

One or more arguments are invalid.

E_OUTOFMEMORY

Out of memory.

E_UNEXPECTED

An unexpected error occurred.

Comments
Notes to Callers
IOleInPlaceActiveObject::ResizeBorder is called by the top-level container's document or frame window object when the border space allocated to the object should change. Because the active in-place object is not informed about which window has changed (the frame- or document-level window), IOleInPlaceActiveObject::ResizeBorder must be passed the pointer to the window's IOleInPlaceUIWindow interface.

Notes to Implementors
In most cases, resizing only requires that you grow, shrink, or scale your ojbect's frame adornments. However, for more complicated adornments, you may be required to renegotiate for border space with calls to IOleInPlaceUIWindow::RequestBorderSpace and IOleInPlaceUIWindow::SetBorderSpace.

Note While executing IOleInPlaceActiveObject::ResizeBorder, do not make calls to the Windows PeekMessage or GetMessage functions, or a dialog box. Doing so may cause the system to deadlock. There are further restrictions on which OLE interface mehtods and functions can be called from within ResizeBorder.

See Also
IOleInPlaceUIWindow::GetBorder
PeekMessage, GetMessage in Win32

Software for developers: Delphi Components
.Net Components
Software for Android Developers
More information resources: MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers: Amazon Categories Database
Browse Nodes Database