QAxFactory Class

Dokumentation der Mitgliedsfunktionen

QAxFactory::QAxFactory(const QUuid &libid, const QUuid &appid)

Konstruiert ein QAxFactory-Objekt, das libid und appid in der Implementierung der jeweiligen Schnittstellenfunktionen zurückgibt.

[override virtual noexcept] QAxFactory::~QAxFactory()

Zerstört das Objekt QAxFactory.

[virtual] QUuid QAxFactory::appID() const

Reimplementieren Sie diese Funktion, um die Anwendungskennung des ActiveX-Servers zurückzugeben.

[virtual] QUuid QAxFactory::classID(const QString &key) const

Reimplementieren Sie diese Funktion, um den Klassenidentifikator für jedes key zurückzugeben, das von der featureList()-Implementierung zurückgegeben wird, oder ein leeres QUuid, wenn diese Fabrik den Wert von key nicht unterstützt.

Die Standardimplementierung interpretiert key als den Klassennamen und gibt den Wert des Q_CLASSINFO()-Eintrags "ClassID" zurück.

[pure virtual] QObject *QAxFactory::createObject(const QString &key)

Reimplementieren Sie diese Funktion, um ein neues Objekt für key zurückzugeben, oder 0, wenn diese Fabrik den Wert von key nicht unterstützt.

Wenn das zurückgegebene Objekt ein QWidget ist, wird es als ActiveX-Steuerelement dargestellt, andernfalls wird das zurückgegebene Objekt als einfaches COM-Objekt dargestellt.

[virtual] bool QAxFactory::createObjectWrapper(QObject *object, IDispatch **wrapper)

Reimplementieren Sie diese Funktion, um das COM-Objekt für object in wrapper bereitzustellen. Geben Sie true zurück, wenn die Funktion erfolgreich war; andernfalls geben Sie false zurück.

Die Standardimplementierung erstellt einen generischen Automations-Wrapper auf der Grundlage der Meta-Objektinformationen von object.

[virtual] QUuid QAxFactory::eventsID(const QString &key) const

Reimplementieren Sie diese Funktion, um den Bezeichner der Ereignisschnittstelle für jedes key zurückzugeben, das von der featureList()-Implementierung zurückgegeben wird, oder ein leeres QUuid, wenn diese Fabrik den Wert von key nicht unterstützt.

Die Standardimplementierung interpretiert key als den Klassennamen und gibt den Wert des Q_CLASSINFO()-Eintrags "EventsID" zurück.

[virtual] QString QAxFactory::exposeToSuperClass(const QString &key) const

Reimplementieren Sie diese Funktion, um den Namen der Superklasse von key zurückzugeben, bis zu der Methoden und Eigenschaften durch das ActiveX-Steuerelement ausgesetzt werden sollen.

Die Standardimplementierung interpretiert key als den Klassennamen und gibt den Wert des Q_CLASSINFO() Eintrags "ToSuperClass" zurück. Wenn kein solcher Wert gesetzt ist, wird der Null-String zurückgegeben und die Funktionen und Eigenschaften aller Superklassen, einschließlich QWidget, werden angezeigt.

Um nur die Funktionen und Eigenschaften der Klasse selbst freizulegen, implementieren Sie diese Funktion neu und geben Sie key zurück.

[pure virtual] QStringList QAxFactory::featureList() const

Reimplementieren Sie diese Funktion, um eine Liste der Widgets (Klassennamen) zurückzugeben, die von dieser Fabrik unterstützt werden.

[virtual] bool QAxFactory::hasStockEvents(const QString &key) const

Implementieren Sie diese Funktion neu, um true zurückzugeben, wenn das ActiveX-Steuerelement key die Standard-ActiveX-Ereignisse unterstützen soll

• Klick
• DblClick
• KeyDown
• Tastendruck
• KeyUp
• MausAb
• MausAuf
• MausBewegung

Die Standardimplementierung interpretiert key als den Klassennamen und gibt true zurück, wenn der Wert des Q_CLASSINFO() Eintrags "StockEvents" "yes" ist. Andernfalls gibt diese Funktion false zurück.

[virtual] QUuid QAxFactory::interfaceID(const QString &key) const

Reimplementieren Sie diese Funktion, um die Schnittstellenkennung für jede key zurückzugeben, die von der featureList()-Implementierung zurückgegeben wird, oder eine leere QUuid, wenn diese Fabrik den Wert von key nicht unterstützt.

Die Standardimplementierung interpretiert key als den Klassennamen und gibt den Wert des Q_CLASSINFO()-Eintrags "InterfaceID" zurück.

[static] bool QAxFactory::isServer()

Gibt true zurück, wenn die Anwendung (von COM) als ActiveX-Server gestartet wurde, andernfalls wird false zurückgegeben.

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

[virtual] bool QAxFactory::isService() const

Reimplementieren Sie diese Funktion, um true zurückzugeben, wenn der Server als dauerhafter Dienst (z.B. ein NT-Dienst) läuft und nicht beendet werden soll, auch wenn alle bereitgestellten Objekte freigegeben wurden.

Die Standardimplementierung gibt false zurück.

[pure virtual] const QMetaObject *QAxFactory::metaObject(const QString &key) const

Reimplementieren Sie diese Funktion, um den QMetaObject entsprechend key zurückzugeben, oder 0, wenn diese Fabrik den Wert von key nicht unterstützt.

[static] bool QAxFactory::registerActiveObject(QObject *object)

Registriert das Objekt QObject object bei COM als laufendes Objekt und gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls false. Das Objekt wird automatisch deregistriert, wenn es zerstört wird.

Diese Funktion sollte nur aufgerufen werden, wenn die Anwendung vom Benutzer gestartet wurde (d.h. nicht von COM, um auf eine Anforderung zu reagieren), und nur für ein Objekt, normalerweise das oberste Objekt der Objekthierarchie der Anwendung.

Diese Funktion tut nichts und gibt false zurück, wenn die Klasseninfo des Objekts für "RegisterObject" nicht auf "yes" gesetzt ist oder wenn der Server ein prozessinterner Server ist.

[virtual] void QAxFactory::registerClass(const QString &key, QSettings *settings) const

Registriert zusätzliche Werte für die Klasse key in der Systemregistrierung unter Verwendung des settings Objekts. Die Standardwerte sind bereits vom Framework registriert worden, aber zusätzliche Werte, z. B. implementierte Kategorien, können in einer Implementierung dieser Funktion hinzugefügt werden.

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

Wenn Sie diese Funktion neu implementieren, müssen Sie auch unregisterClass() neu implementieren, um die zusätzlichen Registry-Werte zu entfernen.

Siehe auch QSettings.

[static] QString QAxFactory::serverDirPath()

Gibt das Verzeichnis zurück, das die Server-Binärdatei enthält.

Bei Out-of-Process-Servern ist dies dasselbe wie QCoreApplication::applicationDirPath(). Bei prozessinternen Servern gibt diese Funktion das Verzeichnis zurück, das die Host-Anwendung enthält.

[static] QString QAxFactory::serverFilePath()

Gibt den Dateipfad der Server-Binärdatei zurück.

Bei Out-of-Process-Servern ist dies dasselbe wie QCoreApplication::applicationFilePath(). Bei prozessinternen Servern gibt diese Funktion den Dateipfad der Hostanwendung zurück.

[static] bool QAxFactory::startServer(QAxFactory::ServerType type = MultipleInstances)

Startet den COM-Server mit type und gibt bei Erfolg true zurück, andernfalls false.

Der Aufruf dieser Funktion, wenn der Server bereits läuft (oder bei einem prozessinternen Server), bewirkt nichts und gibt true zurück.

Der Server wird automatisch mit type gestartet, das auf MultipleInstances gesetzt ist, wenn die ausführbare Serverdatei mit dem Befehlszeilenparameter -activex gestartet wurde. Um zu SingleInstance zu wechseln, rufen Sie

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

in Ihrer eigenen main()-Einstiegspunkt-Funktion auf.

[virtual] bool QAxFactory::stayTopLevel(const QString &key) const

Implementieren Sie diese Funktion neu, um true zurückzugeben, wenn das ActiveX-Steuerelement key ein Fenster der obersten Ebene sein soll, z. B. ein Dialog. Die Standardimplementierung gibt false zurück.

[static] bool QAxFactory::stopServer()

Stoppt den COM-Server und gibt bei Erfolg true zurück, andernfalls false.

Der Aufruf dieser Funktion, wenn der Server nicht läuft (oder bei einem prozessinternen Server), bewirkt nichts und gibt true zurück.

Durch das Anhalten des Servers werden vorhandene Objekte nicht ungültig, aber es können keine neuen Objekte vom vorhandenen Serverprozess erstellt werden. Normalerweise wird COM einen neuen Serverprozess starten, wenn zusätzliche Objekte angefordert werden.

Der Server wird automatisch gestoppt, wenn die Funktion main() zurückkehrt.

[virtual] QUuid QAxFactory::typeLibID() const

Reimplementieren Sie diese Funktion, um die Kennung der Typbibliothek des ActiveX-Servers zurückzugeben.

[virtual] void QAxFactory::unregisterClass(const QString &key, QSettings *settings) const

Deregistriert alle zusätzlichen Werte für die Klasse key aus der Systemregistrierung über das Objekt settings.

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

Siehe auch registerClass() und QSettings.

[virtual] bool QAxFactory::validateLicenseKey(const QString &key, const QString &licenseKey) const

Reimplementieren Sie diese Funktion so, dass sie true zurückgibt, wenn licenseKey eine gültige Lizenz für die Klasse key ist, oder wenn der aktuelle Rechner lizenziert ist.

Die Standardimplementierung gibt true zurück, wenn die Klasse key nicht lizenziert ist (d.h. kein Q_CLASSINFO() -Attribut "LicenseKey"), oder wenn licenseKey mit dem Wert des Attributs "LicenseKey" übereinstimmt, oder wenn der Rechner über eine .LIC-Datei mit demselben Dateinamen wie dieser COM-Server lizenziert ist.