IOleInPlaceSiteEx BM3EAR

The IOleInPlaceSiteEx interface provides an additional set of activation and deactivation notification methods that enable an object to avoid unnecessary flashing on the screen when the object is activated and deactivated.

When an object is activated, it does not know if its visual display is already correct. When the object is deactivated, the container does not know if the visual display is correct. To avoid a redraw and the associated screen flicker in both cases, the container can provide this extension to IOleInPlaceSiteY06K6Q.

When to Implement

Implement this interface on the client site in a container application that supports flicker-free activation and deactivation of embedded, in-place active objects.

When to Use

An embedded object, such as a control, calls the methods in this interface to determine if it needs to redraw itself on activation and to notify the container if the object needs to be redrawn on deactivation. By avoiding the redraw when it is not needed, you can reduce the amount of flashing on the screen.

If the site object does not support IOleInPlaceSiteEx, the object must call methods in the IOleInPlaceSite interface instead. In this case, the object must redraw itself on activation and deactivation.

Methods in Vtable Order

IUnknown1NEM0LU Methods	Description
QueryInterface2Y54585	Returns a pointer to a specified interface.
AddRef1SHW0SS	Increments the reference count.
ReleaseDUW01A	Decrements the reference count.

IOleWindow13880GC Methods	Description
GetWindow2MLJP1W	Gets a window handle.
ContextSensitiveHelp2Q6WFYP	Controls enabling of context-sensitive help.

IOleInPlaceSiteY06K6Q Methods	Description
CanInPlaceActivate5.GP63	Determines if the container can activate the object in place.
OnInPlaceActivate21AR_OT	Notifies the container that one of its objects is being activated in place.
OnUIActivate5232W_	Notifies the container that the object is about to be activated in place, and that the main menu will be replaced by a composite menu.
GetWindowContext1JHMDO6	Enables an in-place object to retrieve window interfaces that form at the window object hierarchy, and the position in the parent window to locate the object s in-place activation window.
Scroll1SRUO.O	Specifies the number of pixels by which the container is to scroll the object.
OnUIDeactivate180U5RZ	Notifies the container to reinstall its user interface and take focus.
OnInPlaceDeactivate1MSCZVK	Notifies the container that the object is no longer active in place.
DiscardUndoState.YCR5X	Instructs the container to discard its undo state.
DeactivateAndUndo.9LXKI	Deactivate the object and revert to undo state.
OnPosRectChange19GMV2S	Object s extents have changed.

IOleInPlaceSiteEx Methods	Description
OnInPlaceActivateEx1MZKFMP	Called by the embedded object to determine if it needs to redraw itself upon activation.
OnInPlaceDeactivateEx.L9AAB	Notifies the container of whether the object needs to be redrawn upon deactivation.
RequestUIActivate413HDC	Notifies the container that the object is about to enter the UI-active state.

See Also

IOleInPlaceSite