|
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
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
