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.
Members
The IOleControlSite interface inherits from the IUnknown interface. IOleControlSite also has these types of members:
Methods
The IOleControlSite interface has these methods.
| Method | Description |
|---|---|
| GetExtendedControl |
Retrieves an IDispatch pointer to the extended control that the container uses to wrap the real control. |
| LockInPlaceActive |
Indicates whether a control should remain in-place active. |
| 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. |
| OnFocus |
Indicates whether the control managed by this control site has gained or lost the focus. |
| ShowPropertyFrame |
Instructs a container to display a property sheet for the control embedded in this site. |
| TransformCoords |
Converts coordinates expressed in HIMETRIC units (as is standard in OLE) to the units specified by the container. |
| TranslateAccelerator |
Passes a keystroke to the control site for processing. |
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps | Windows Store apps] |
|
Header |
|
|
IDL |
|
|
IID |
IID_IOleControlSite is defined as B196B289-BAB4-101A-B69C-00AA00341D07 |
See also