COleControlSite Class

Article
01/08/2013

Provides support for custom client-side control interfaces.

class COleControlSite : public CCmdTarget

Members

Public Constructors

Name	Description
COleControlSite::COleControlSite	Constructs a COleControlSite object.

Public Methods

Name	Description
COleControlSite::BindDefaultProperty	Binds the default property of the hosted control to a data source.
COleControlSite::BindProperty	Binds a property of the hosted control to a data source.
COleControlSite::CreateControl	Creates a hosted ActiveX control.
COleControlSite::DestroyControl	Destroys the hosted control.
COleControlSite::DoVerb	Executes a specific verb of the hosted control.
COleControlSite::EnableDSC	Enables data sourcing for a control site.
COleControlSite::EnableWindow	Enables the control site.
COleControlSite::FreezeEvents	Specifies if the control site is accepting events.
COleControlSite::GetDefBtnCode	Retrieves the default button code for the hosted control.
COleControlSite::GetDlgCtrlID	Retrieves the identifier of the control.
COleControlSite::GetEventIID	Retrieves the ID of an event interface for a hosted control.
COleControlSite::GetExStyle	Retrieves the extended styles of the control site.
COleControlSite::GetProperty	Retrieves a specific property of the hosted control.
COleControlSite::GetStyle	Retrieves the styles of the control site.
COleControlSite::GetWindowText	Retrieves the text of the hosted control.
COleControlSite::InvokeHelper	Invoke a specific method of the hosted control.
COleControlSite::InvokeHelperV	Invoke a specific method of the hosted control with a variable list of arguments.
COleControlSite::IsDefaultButton	Determines if the control is the default button in the window.
COleControlSite::IsWindowEnabled	Checks the visible state of the control site.
COleControlSite::ModifyStyle	Modifies the current extended styles of the control site.
COleControlSite::ModifyStyleEx	Modifies the current styles of the control site.
COleControlSite::MoveWindow	Changes the position of the control site.
COleControlSite::QuickActivate	Quick activates the hosted control.
COleControlSite::SafeSetProperty	Sets a property or method of the control without chance of throwing an exception.
COleControlSite::SetDefaultButton	Sets the default button in the window.
COleControlSite::SetDlgCtrlID	Retrieves the identifier of the control.
COleControlSite::SetFocus	Sets the focus to the control site.
COleControlSite::SetProperty	Sets a specific property of the hosted control.
COleControlSite::SetPropertyV	Sets a specific property of the hosted control with a variable list of arguments.
COleControlSite::SetWindowPos	Sets the position of the control site.
COleControlSite::SetWindowText	Sets the text of the hosted control.
COleControlSite::ShowWindow	Shows or hides the control site.

Protected Methods

Name	Description
COleControlSite::GetControlInfo	Retrieves keyboard information and mnemonics for the hosted control.

Public Data Members

Name	Description
COleControlSite::m_bIsWindowless	Determines if the hosted control is a windowless control.
COleControlSite::m_ctlInfo	Contains information on keyboard handling for the control.
COleControlSite::m_dwEventSink	The cookie of the control's connection point.
COleControlSite::m_dwMiscStatus	The miscellaneous states for the hosted control.
COleControlSite::m_dwPropNotifySink	The IPropertyNotifySink cookie of the control.
COleControlSite::m_dwStyle	The styles of the hosted control.
COleControlSite::m_hWnd	The handle of the control site.
COleControlSite::m_iidEvents	The ID of the event interface for the hosted control.
COleControlSite::m_nID	The ID of the hosted control.
COleControlSite::m_pActiveObject	A pointer to the IOleInPlaceActiveObject object of the hosted control.
COleControlSite::m_pCtrlCont	The container of the hosted control.
COleControlSite::m_pInPlaceObject	A pointer to the IOleInPlaceObject object of the hosted control.
COleControlSite::m_pObject	A pointer to the IOleObjectInterface interface of the control.
COleControlSite::m_pWindowlessObject	A pointer to the IOleInPlaceObjectWindowless interface of the control.
COleControlSite::m_pWndCtrl	A pointer to the window object for the hosted control.
COleControlSite::m_rect	The dimensions of the control site.

Remarks

This support is the primary means by which an embedded ActiveX control obtains information about the location and extent of its display site, its moniker, its user interface, its ambient properties, and other resources provided by its container. COleControlSite fully implements the IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEvents, IRowSetNotify interfaces. In addition, the IDispatch interface (providing support for ambient properties and event sinks) is also implemented.

To create an ActiveX control site using COleControlSite, derive a class from COleControlSite. In your CWnd-derived class for the container (for instance, your dialog box) override the CWnd::CreateControlSite function.

Inheritance Hierarchy

CObject

CCmdTarget

COleControlSite

Requirements

Header: afxocc.h