The IOleControlSite interface provides the methods that enable a site object to manage each embedded control within a container. A site object provides IOleControlSite as well as other site interfaces such as IOleClientSite and IOleInPlaceSite. When a control requires the services expressed through this interface, it will query one of the other client site interfaces for IOleControlSite.
When to Implement
Implement this interface on an in-place capable site object to support the embedding of controls in the site.
When to Use
A control uses this interface to work with a control-aware container.
Methods in VTable Order
| IUnknown method | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments the reference count. |
| Release | Decrements the reference count. |
| IOleControlSite Methods | Description |
|---|---|
| OnControlInfoChanged | Informs the container that the control's CONTROLINFO structure has changed and that the container should call the control's IOleControl::GetControlInfo for an update. |
| LockInPlaceActive | Indicates whether or not this control should remain in-place active, regardless of possible deactivation events. |
| GetExtendedControl | Requests an IDispatch pointer to the extended control that the container uses to wrap the real control. |
| TransformCoords | Converts between a POINTL structure expressed in HIMETRIC units (as is standard in OLE) and a POINTF structure expressed in units the container specifies. |
| TranslateAccelerator | Instructs the container to process a specified keystroke. |
| OnFocus | Indicates whether the embedded control in this control site has gained or lost the focus. |
| ShowPropertyFrame | Instructs the container to show a property page frame for the control object if the container so desires. |
Requirements
OS Versions: Windows CE 4.0 and later.
Header: ocidl.h.
See Also
Send Feedback on this topic to the authors