IOleInPlaceSiteWindowless::InvalidateRect
Enables an object to invalidate a specified rectangle of its in-place image on
the screen.
HRESULT InvalidateRect(
LPCRECT pRect,
|
//Rectangle to be invalidated
|
BOOL fErase
|
//Indicates whether to erase the background
|
);
|
|
Parameters
-
pRect
-
[in] Rectangle to invalidate, in client coordinates of the containing window.
If this parameter is NULL, the object’s full extent is invalidated.
-
fErase
-
[in] Specifies whether the background within the update region is to be erased
when the region is updated. If this parameter is TRUE, the background is
erased. If this parameter is FALSE, the background remains unchanged.
Return Values
-
S_OK
-
The specified rectangle was successfully invalidated.
Remarks
An object is only allowed to invalidate pixels contained in its own site
rectangle. Any attempt to invalidate an area outside of that rectangle should
result in a no-op.