- Qt 6.10
- Active Qt
- ActiveQt Examples and Tutorials
- Wrapper Example (ActiveQt)
- Qt 6.10.3 Reference Documentation

# Wrapper Example (ActiveQt)

The Wrapper example demonstrates how to export existing QWidget classes as ActiveX controls, and the use of QAxFactory together with the `QAXFACTORY_EXPORT()` macro. ActiveX controls in this example are the standard button classes QPushButton, QCheckBox and QRadioButton as provided by Qt.

     class ActiveQtFactory : public QAxFactory
     {
     public:
         ActiveQtFactory(const QUuid &lib, const QUuid &app)
             : QAxFactory(lib, app)
         {}

         QStringList featureList() const override
         {
             return m_activeElements.keys();
         }

         QObject *createObject(const QString &key) override
         {
             auto it = m_activeElements.find(key);
             if (it != m_activeElements.end())
                 return it->create();
             return nullptr;
         }

         const QMetaObject *metaObject(const QString &key) const override
         {
             auto it = m_activeElements.find(key);
             if (it != m_activeElements.end())
                 return it->metaObject;
             return nullptr;
         }

         QUuid classID(const QString &key) const override
         {
             auto it = m_activeElements.find(key);
             if (it != m_activeElements.end())
                 return it->classID;
             return QUuid();
         }

         QUuid interfaceID(const QString &key) const override
         {
             auto it = m_activeElements.find(key);
             if (it != m_activeElements.end())
                 return it->interfaceID;
             return QUuid();
         }

         QUuid eventsID(const QString &key) const override
         {
             auto it = m_activeElements.find(key);
             if (it != m_activeElements.end())
                 return it->eventsID;
             return QUuid();
         }

     private:

         struct ActiveElement {
            QUuid classID;
            QUuid interfaceID;
            QUuid eventsID;
            const QMetaObject *metaObject;
            std::function<QObject *()> create;
         };

         const QHash<QString, ActiveElement> m_activeElements {
             {
                 QStringLiteral("QCheckBox"), {
                     QUuid("{6E795DE9-872D-43CF-A831-496EF9D86C68}"),
                     QUuid("{4FD39DD7-2DE0-43C1-A8C2-27C51A052810}"),
                     QUuid("{FDB6FFBE-56A3-4E90-8F4D-198488418B3A}"),
                     &QCheckBox::staticMetaObject,
                     []() { return new QCheckBox; }
                 }
             },
             {
                 QStringLiteral("QRadioButton"), {
                     QUuid("{AFCF78C8-446C-409A-93B3-BA2959039189}"),
                     QUuid("{7CC8AE30-206C-48A3-A009-B0A088026C2F}"),
                     QUuid("{73EE4860-684C-4A66-BF63-9B9EFFA0CBE5}"),
                     &QRadioButton::staticMetaObject,
                     []() { return new QRadioButton; }
                 }
             },
             {
                 QStringLiteral("QPushButton"), {
                     QUuid("{2B262458-A4B6-468B-B7D4-CF5FEE0A7092}"),
                     QUuid("{06831CC9-59B6-436A-9578-6D53E5AD03D3}"),
                     QUuid("{3CC3F17F-EA59-4B58-BBD3-842D467131DD}"),
                     &QPushButton::staticMetaObject,
                     []() { return new QPushButton; }
                 }
             },
             {
                 QStringLiteral("QToolButton"), {
                     QUuid("{7c0ffe7a-60c3-4666-bde2-5cf2b54390a1}"),
                     QUuid("{6726080f-d63d-4950-a366-9bf33e5cdf84}"),
                     QUuid("{f4d421fd-4ead-4fd9-8a25-440766939639}"),
                     &QToolButton::staticMetaObject,
                     []() { return new QToolButton; }
                 }
             },
         };

     };

The factory implementation returns the list of supported controls, creates controls on request and provides information about the unique IDs of the COM classes and interfaces for each control.

     QAXFACTORY_EXPORT(ActiveQtFactory, "{3B756301-0075-4E40-8BE8-5A81DE2426B7}", "{AB068077-4924-406a-BBAF-42D91C8727DD}")

The factory is exported using the QAXFACTORY_EXPORT macro.

To build the example you must first build the QAxServer library. Then run `qmake` and your make tool in `examples/activeqt/wrapper`.

The demonstration requires a web browser that supports ActiveX controls, and scripting to be enabled.

     <SCRIPT LANGUAGE="VBScript">
     Sub ToolButton_Clicked()
         RadioButton.text = InputBox( "Enter something", "Wrapper Demo" )
     End Sub

     Sub PushButton_clicked()
         MsgBox( "Thank you!" )
     End Sub

     Sub CheckBox_toggled( state )
         if state = 0 then
             CheckBox.text = "Check me!"
         else
             CheckBox.text = "Uncheck me!"
         end if
     End Sub
     </SCRIPT>
     <p />
     A QPushButton:<br />
     <object ID="PushButton" CLASSID="CLSID:2B262458-A4B6-468B-B7D4-CF5FEE0A7092"
     CODEBASE="http://qt.nokia.com/demos/wrapperax.cab">
         <PARAM NAME="text" VALUE="Click me!" />
     [Object not available! Did you forget to build and register the server?]
     </object><br />

     <p />
     A QCheckBox:<br />
     <object ID="CheckBox" CLASSID="CLSID:6E795de9-872d-43cf-a831-496ef9d86c68"
     CODEBASE="http://qt.nokia.com/demos/wrapperax.cab">
         <PARAM NAME="text" VALUE="Check me!" />
     [Object not available! Did you forget to build and register the server?]
     </object><br />

     <p />
     A QToolButton:<br />
     <object ID="ToolButton" CLASSID="CLSID:7c0ffe7a-60c3-4666-bde2-5cf2b54390a1"
     CODEBASE="http://qt.nokia.com/demos/wrapperax.cab">
     [Object not available! Did you forget to build and register the server?]
     </object><br />

     <p />
     A QRadioButton:<br />
     <object ID="RadioButton" CLASSID="CLSID:afcf78c8-446c-409a-93b3-ba2959039189"
     CODEBASE="http://qt.nokia.com/demos/wrapperax.cab">
         <PARAM NAME="text" VALUE="Tune me!" />
     [Object not available! Did you forget to build and register the server?]
     </object><br />

Example project @ code.qt.io