IOleInPlaceSite::OnPosRectChange method

Notifies the container that the object extents have changed.


HRESULT OnPosRectChange(
  LPCRECT lprcPosRect



A pointer a RECT structure that contains the position of the in-place object in the client coordinates of its parent window.

Return Value

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

Return code Description
The supplied pointer is invalid.
An unexpected error occurred.


Notes to Callers

The OnPosRectChange method is called by the in-place object.

Notes to Implementers

When the in-place object calls OnPosRectChange, the container must call IOleInPlaceObject::SetObjectRects to specify the new position of the in-place window and the clipping rectangle. Only then does the object resize its window.

In most cases, the object grows to the right and/or down. There could be cases where the object grows to the left and/or up, as conveyed through lprcPosRect. It is also possible to change the object's position without changing its size.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header oleidl.h

See Also