Export (0) Print
Expand All

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 IOleInPlaceSite.

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.

Members

The IOleInPlaceSiteEx interface inherits from IOleInPlaceSite. IOleInPlaceSiteEx also has these types of members:

Methods

The IOleInPlaceSiteEx interface has these methods.

MethodDescription
OnInPlaceActivateEx

Called by the embedded object to determine whether it needs to redraw itself upon activation.

OnInPlaceDeactivateEx

Notifies the container whether the object needs to be redrawn upon deactivation.

RequestUIActivate

Notifies the container that the object is about to enter the UI-active state.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IOleInPlaceSiteEx is defined as 9C2CAD80-3424-11CF-B670-00AA004CD6D8

See also

IOleInPlaceSite

 

 

Community Additions

ADD
Show:
© 2014 Microsoft