|
IOleInPlaceUIWindow::SetBorderSpace
Allocates space for the border requested in the call to IOleInPlaceUIWindow::RequestBorderSpace.
HRESULT SetBorderSpace(
LPCBORDERWIDTHS pborderwidths
| //Points to a BORDERWIDTHS structure
| );
|
|
Parameter
pborderwidths
[in] Points to a BORDERWIDTHS structure containing the requested width (in pixels) of the tools. It can be
NULL, indicating the object does not need any space.
Return Values
S_OK
The requested space has been allocated to the object.
OLE_E_INVALIDRECT
The rectangle does not lie within the specifications returned by IOleInPlaceUIWindow::GetBorder.
E_INVALIDARG
One or more arguments are invalid.
E_UNEXPECTED
An unexpected error occurred.
Comments
The object must call IOleInPlaceUIWindow::SetBorderSpace. It can do any of the following:
- Use its own toolbars, requesting border space of a specific size; or,
- Use no toolbars, but force the container to remove its toolbars by passing a
valid BORDERWIDTHS structure containing nothing but zeros in the pborderwidths parameter; or,
- Use no toolbars but allow the in-place container to leave its toolbars up by
passing NULL as the pborderwidths parameter.
The BORDERWIDTHS structure used in this call would generally have been passed in a previous
call to IOleInPlaceUIWindow::RequestBorderSpace, which must have returned S_OK.
If an object must renegotiate space on the border, it can call SetBorderSpace again with the new widths. If the call to SetBorderSpace fails, the object can do a full negotiation for border space with calls to GetBorder, RequestBorderSpace, and SetBorderSpace.
Note While executing IOleInPlaceUIWindow::SetBorderSpace, 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 methods and functions can be
called from within SetBorderSpace.
See Also
IOleInPlaceUIWindow::GetBorder, IOleInPlaceUIWindow::RequestBorderSpace
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
|
