IOleInPlaceSite:IUnknown (Windows CE 5.0)
The IOleInPlaceSite interface manages interaction between the container and the object's in-place client site. Recall that the client site is the display site for embedded objects, and provides position and conceptual information about the object.
This interface provides methods that manage in-place objects. With IOleInPlaceSite, you can determine if an object can be activated and manage its activation and deactivation. You can notify the container when one of its objects is being activated and inform the container that a composite menu will replace the container's regular menu. It provides methods that make it possible for the in-place object to retrieve the window object hierarchy, and the position in the parent window where the object should place its in-place activation window. Finally, it determines how the container scrolls the object, manages the object undo state, and notifies the object when its borders have changed.
When to Implement
You must implement this interface if you are writing a container application that will participate in in-place activation.
When to Use
Use this interface to allow your object to control in-place activation from within the container.
The IOleInPlaceSite interface pointer is obtained by calling QueryInterface on the object's IOleClientSite interface.
Methods in VTable Order
| IUnknown method | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments the reference count. |
| Release | Decrements the reference count. |
| IOleWindow Methods | Description |
|---|---|
| GetWindow | Gets a window handle. |
| ContextSensitiveHelp | Controls enabling of context-sensitive help. |
| IOleInPlaceSite Methods | Description |
|---|---|
| CanInPlaceActivate | Determines if the container can activate the object in place. |
| OnInPlaceActivate | Notifies the container that one of its objects is being activated in place. |
| OnUIActivate | 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. |
| GetWindowContext | 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. |
| Scroll | Specifies the number of pixels by which the container is to scroll the object. |
| OnUIDeactivate | Notifies the container to reinstall its user interface and take focus. |
| OnInPlaceDeactivate | Notifies the container that the object is no longer active in place. |
| DiscardUndoState | Instructs the container to discard its undo state. |
| OnPosRectChange | Object's extents have changed. |
Requirements
OS Versions: Windows CE 4.0 and later.
Header: oleidl.h.
See Also
Send Feedback on this topic to the authors