IOleControlSite

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 Methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements 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.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.

See Also

IOleControl, ISimpleFrameSite