QAxFactory Class Reference
[QAxServer module]

Detailed Description

The QAxFactory class defines a factory for the creation of COM components.

Implement this factory once in your COM server to provide information about the components the server can create. Subclass QAxFactory and implement the pure virtual functions in any implementation file (e.g. main.cpp), and export the factory using the QAXFACTORY_EXPORT() macro.

 QStringList ActiveQtFactory::featureList() const
 {
     QStringList list;
     list << "ActiveX1";
     list << "ActiveX2";
     return list;
 }

 QObject *ActiveQtFactory::createObject(const QString &key)
 {
     if (key == "ActiveX1")
         return new ActiveX1(parent);
     if (key == "ActiveX2")
         return new ActiveX2(parent);
     return 0;
 }

 const QMetaObject *ActiveQtFactory::metaObject(const QString &key) const
 {
     if (key == "ActiveX1")
         return &ActiveX1::staticMetaObject;
     if (key == "ActiveX2")
         return &ActiveX2::staticMetaObject;
 }

 QUuid ActiveQtFactory::classID(const QString &key) const
 {
     if (key == "ActiveX1")
         return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
     ...
     return QUuid();
 }

 QUuid ActiveQtFactory::interfaceID(const QString &key) const
 {
     if (key == "ActiveX1")
         return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
     ...
     return QUuid();
 }

 QUuid ActiveQtFactory::eventsID(const QString &key) const
 {
     if (key == "ActiveX1")
         return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
     ...
     return QUuid();
 }

 QAXFACTORY_EXPORT(
     ActiveQtFactory,                          // factory class
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}"  // application ID
 )

If you use the Q_CLASSINFO() macro to provide the unique identifiers or other attributes for your class you can use the QAXFACTORY_BEGIN(), QAXCLASS() and QAXFACTORY_END() macros to expose one or more classes as COM objects.

 QAXFACTORY_BEGIN(
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}"  // application ID
 )
     QAXCLASS(Class1)
     QAXCLASS(Class2)
 QAXFACTORY_END()

If your server supports just a single COM object, you can use a default factory implementation through the QAXFACTORY_DEFAULT() macro.

 #include <qapplication.h>
 #include <qaxfactory.h>

 #include "theactivex.h"

 QAXFACTORY_DEFAULT(
     TheActiveX,                           // widget class
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // class ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // interface ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // event interface ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}"  // application ID
 )

Only one QAxFactory implementation may be instantiated and exported by an ActiveX server application. This instance is accessible through the global qAxFactory() function.

A factory can also reimplement the registerClass() and unregisterClass() functions to set additional flags for an ActiveX control in the registry. To limit the number of methods or properties a widget class exposes from its parent classes reimplement exposeToSuperClass().

See also QAxAggregated, QAxBindable, and ActiveQt Framework.

Member Type Documentation

 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);
     if (!QAxFactory::isServer()) {
         // initialize for stand-alone execution
     }
     return app.exec();
 }

 settings->setValue("/CLSID/" + classID(key)
                    + "/Implemented Categories/"
                    + "/{00000000-0000-0000-000000000000}/.",
                    QString());

 if (QAxFactory::isServer()) {
     QAxFactory::stopServer();
     QAxFactory::startServer(QAxFactory::SingleInstance);
 }

 settings->remove("/CLSID/" + classID(key)
                  + "/Implemented Categories"
                  + "/{00000000-0000-0000-000000000000}/.");

 QAXFACTORY_BEGIN(
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}"  // application ID
 )
     QAXCLASS(Class1)
     QAXCLASS(Class2)
 QAXFACTORY_END()

 #include <qaxfactory.h>

 #include "theactivex.h"

 QAXFACTORY_DEFAULT(
     TheActiveX,                           // widget class
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // class ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // interface ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // event interface ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}"  // application ID
 )

 QAXFACTORY_EXPORT(
     MyFactory,                                // factory class
     "{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
     "{01234567-89AB-CDEF-0123-456789ABCDEF}"  // application ID
 )