Home

QtControlHost Class Reference

A ControlHost is a widget that can host Microsoft.Net controls within a Qt application. More...

 #include <QtControlHost>

Inherits QWidget.

• List of all members, including inherited members

Properties

• controlAssembly : QString
• controlOwnership : QtWinFormsEnums::OwnershipType
• controlType : QString

• 57 properties inherited from QWidget
• 1 property inherited from QObject

Public Functions

• QtControlHost ( QWidget * parent = 0 )
• QtControlHost ( System::Windows::Forms::Control ^ hostedControl, QWidget * parent = 0 )
• ~QtControlHost ()
• virtual System::Windows::Forms::Control ^ control () const
• QString controlAssembly () const
• QtWinFormsEnums::OwnershipType controlOwnership () const
• QString controlType () const
• virtual QSize minimumSizeHint () const
• virtual void setControl ( System::Windows::Forms::Control ^ hostedControl )
• void setControlAssembly ( const QString & controlAssembly )
• void setControlOwnership ( QtWinFormsEnums::OwnershipType controlOwnership )
• void setControlType ( const QString & controlType )
• virtual QSize sizeHint () const

• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 12 public functions inherited from QPaintDevice

Static Public Members

• System::Windows::Forms::Control ^ createControl ( const QString & controlType, const QString & controlAssembly = QString() )

• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject

Protected Functions

• virtual bool event ( QEvent * e )
• virtual void focusInEvent ( QFocusEvent * e )
• virtual void resizeEvent ( QResizeEvent * e )
• virtual void showEvent ( QShowEvent * e )

• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice

Additional Inherited Members

• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 signal inherited from QWidget
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

A ControlHost is a widget that can host Microsoft.Net controls within a Qt application.

The hosted control can be associated with the ControlHost in several ways, one way is to allocate the control and then pass the reference to the constructor of the ControlHost:

 calendar = gcnew System::Windows::Forms::MonthCalendar();
 calendarHost = new QtControlHost(calendar, this);

Or one can change the control of the ControlHost by modifying the controlAssembly and controlType properties:

 calendarHost = new QtControlHost(this);
 calendarHost->setControlAssembly("system.windows.forms.dll");
 calendarHost->setControlType("System.Windows.Forms.MonthCalendar");

The last one allows dynamic creation of hosted controls without being dependent on a managed c++ extension.

Note that the ControlHost does not give an interface to modify the properties of the hosted control. If you need to call methods or modify some properties of the hosted control, you must operate directly on the hosted control. Use QtControlHost::control() to get a reference to the hosted control. If you rather want to embed a Qt widget within a .Net application you should use the WidgetHost.

Property Documentation

controlAssembly : QString

This property holds the assembly of the hosted control.

Access functions:

• QString controlAssembly () const
• void setControlAssembly ( const QString & controlAssembly )

controlOwnership : QtWinFormsEnums::OwnershipType

This property holds the ownership of the Winforms control. If controlOwnership is External, an external object has the ownership of the control, and the ControlHost will not destroy the Control when ControlHost is destroyed or if the Control is changed with setControl().

Access functions:

• QtWinFormsEnums::OwnershipType controlOwnership () const
• void setControlOwnership ( QtWinFormsEnums::OwnershipType controlOwnership )

controlType : QString

This property holds the type of the hosted control.

Access functions:

• QString controlType () const
• void setControlType ( const QString & controlType )

Member Function Documentation

QtControlHost::QtControlHost ( QWidget * parent = 0 )

Constructs a new ControlHost with the parent widget and no winforms control.

QtControlHost::QtControlHost ( System::Windows::Forms::Control ^ hostedControl, QWidget * parent = 0 )

Constructs a new ControlHost with the parent widget and the hosted control hostedControl

QtControlHost::~QtControlHost ()

Destructs the ControlHost. If the property controlOwnership is set to Host, the hosted control will be destroyed.

System::Windows::Forms::Control ^ QtControlHost::control () const   [virtual]

Returns the hosted control.

See also setControl().

System::Windows::Forms::Control ^ QtControlHost::createControl ( const QString & controlType, const QString & controlAssembly = QString() )   [static]

Creates a winforms control using the assembly controlAssembly and type controlType.

See also controlAssembly and controlType.

bool QtControlHost::event ( QEvent * e )   [virtual protected]

Reimplemented from QWidget::event(QEvent *e), and notifies the hosted control for some values of e that the hosted control is expected to react to. This function implements a method of QWidget that enables the hosted control to respond as expected when the event e occurs.

Reimplemented from QObject.

void QtControlHost::focusInEvent ( QFocusEvent * e )   [virtual protected]

This function implements a method of QWidget that enables the hosted control to respond as expected when the event e occurs.

Reimplemented from QWidget.

QSize QtControlHost::minimumSizeHint () const   [virtual]

Returns the minimum size of the hosted control.

Reimplemented from QWidget.

void QtControlHost::resizeEvent ( QResizeEvent * e )   [virtual protected]

This function implements a method of QWidget that enables the hosted control to respond as expected when the event e occurs.

Reimplemented from QWidget.

void QtControlHost::setControl ( System::Windows::Forms::Control ^ hostedControl )   [virtual]

Assigns the hosted control to hostedControl.

See also control().

void QtControlHost::showEvent ( QShowEvent * e )   [virtual protected]

Will show the hosted control. This function implements a method of QWidget that enables the hosted control to respond as expected when the event e occurs.

Reimplemented from QWidget.

QSize QtControlHost::sizeHint () const   [virtual]

Returns the preferred size of the hosted control.

Reimplemented from QWidget.