QAxBindable Class Reference
[QAxServer module]

Detailed Description

The QAxBindable class provides an interface between a QWidget and an ActiveX client.

The functions provided by this class allow an ActiveX control to communicate property changes to a client application. Inherit your control class from both QWidget (directly or indirectly) and this class to get access to this class's functions. The meta-object compiler requires you to inherit from QWidget first.

 class MyActiveX : public QWidget, public QAxBindable
 {
     Q_OBJECT
     Q_PROPERTY(int value READ value WRITE setValue)

 public:
     MyActiveX(QWidget *parent = 0);
     ...

     int value() const;
     void setValue(int);
 };

When implementing the property write function, use requestPropertyChange() to get permission from the ActiveX client application to change this property. When the property changes, call propertyChanged() to notify the ActiveX client application about the change. If a fatal error occurs in the control, use the static reportError() function to notify the client.

Use the interface returned by clientSite() to call the ActiveX client. To implement additional COM interfaces in your ActiveX control, reimplement createAggregate() to return a new object of a QAxAggregated subclass.

The ActiveQt OpenGL example shows how to use QAxBindable to implement additional COM interfaces.

See also QAxAggregated, QAxFactory, and ActiveQt Framework.

Member Function Documentation

 void MyActiveQt::setText(const QString &text)
 {
     if (!requestPropertyChange("text"))
         return;

     // update property

     propertyChanged("text");
 }