nf-oleidl-ioleinplaceactiveobject-resizeborder.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:oleidl.IOleInPlaceActiveObject.ResizeBorder	IOleInPlaceActiveObject::ResizeBorder (oleidl.h)	Alerts the object that it needs to resize its border space.	IOleInPlaceActiveObject interface [COM] ResizeBorder method IOleInPlaceActiveObject.ResizeBorder IOleInPlaceActiveObject::ResizeBorder ResizeBorder ResizeBorder method [COM] ResizeBorder method [COM] IOleInPlaceActiveObject interface _ole_ioleinplaceactiveobject_resizeborder com.ioleinplaceactiveobject_resizeborder oleidl/IOleInPlaceActiveObject::ResizeBorder	com\ioleinplaceactiveobject_resizeborder.htm	com	240d2ae5-abce-4bea-969e-f47780908bbb	12/05/2018	IOleInPlaceActiveObject interface [COM],ResizeBorder method, IOleInPlaceActiveObject.ResizeBorder, IOleInPlaceActiveObject::ResizeBorder, ResizeBorder, ResizeBorder method [COM], ResizeBorder method [COM],IOleInPlaceActiveObject interface, _ole_ioleinplaceactiveobject_resizeborder, com.ioleinplaceactiveobject_resizeborder, oleidl/IOleInPlaceActiveObject::ResizeBorder	oleidl.h		Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]					OleIdl.Idl								Windows			19H1	IOleInPlaceActiveObject::ResizeBorder oleidl/IOleInPlaceActiveObject::ResizeBorder	c++	APIRef kbSyntax	COM	OleIdl.h	IOleInPlaceActiveObject.ResizeBorder

IOleInPlaceActiveObject::ResizeBorder

-description

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

-parameters

-param prcBorder [in]

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

-param pUIWindow [in]

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

-param fFrameWindow [in]

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

-returns

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

Return code	Description
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 Implementers

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.

 

-see-also

GetMessage

IOleInPlaceActiveObject

IOleInPlaceUIWindow::GetBorder

PeekMessage