Export (0) Print
Expand All

IOleInPlaceActiveObject::ResizeBorder method

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

Syntax


HRESULT ResizeBorder(
  [in]  LPCRECT prcBorder,
  [in]  IOleInPlaceUIWindow *pUIWindow,
  [in]  BOOL fFrameWindow
);

Parameters

prcBorder [in]

A pointer to a RECT structure containing the new outer rectangle within which the object can request border space for its tools.

pUIWindow [in]

A pointer to an IOleInPlaceUIWindow interface pointer for the frame or document window object whose border has changed.

fFrameWindow [in]

This parameter is TRUE if the frame window object is calling IOleInPlaceActiveObject::ResizeBorder; otherwise, it is FALSE.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
E_INVALIDARG

The specified parameter values are not valid.

E_OUTOFMEMORY

There is insufficient memory available for the operation.

E_UNEXPECTED

An unexpected error occurred.

 

Remarks

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 Implemeters

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

Note  While executing IOleInPlaceActiveObject::ResizeBorder, do not make calls to the 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 IOleInPlaceActiveObject::ResizeBorder.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleInPlaceActiveObject is defined as 00000117-0000-0000-C000-000000000046

See also

GetMessage
IOleInPlaceActiveObject
IOleInPlaceUIWindow::GetBorder
PeekMessage

 

 

Community Additions

ADD
Show:
© 2014 Microsoft