QAxFactory Class

Dokumentation zu Mitgliedsfunktionen

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

Erstellt ein QAxFactory-Objekt, das bei der Implementierung der jeweiligen Schnittstellenfunktionen die Werte „ libid “ und „ appid “ zurückgibt.

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

Löscht das „ QAxFactory “-Objekt.

[virtual] QUuid QAxFactory::appID() const

Implementieren Sie diese Funktion neu, damit sie die Anwendungs-ID des ActiveX-Servers zurückgibt.

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

Implementieren Sie diese Funktion neu, sodass sie für jedes von der Implementierung von ` featureList()` zurückgegebene ` key ` die Klassenkennung zurückgibt – oder ein leeres ` QUuid `, falls diese Factory den Wert ` key` nicht unterstützt.

Die Standardimplementierung interpretiert ` key ` als Klassennamen und gibt den Wert des Eintrags „ClassID“ aus ` Q_CLASSINFO()` zurück.

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

Implementieren Sie diese Funktion neu, sodass sie ein neues Objekt für „ key “ zurückgibt oder 0, falls diese Factory den Wert „ key “ nicht unterstützt.

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

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

Implementieren Sie diese Funktion neu, 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 Automation-Wrapper auf der Grundlage der Metaobjektinformationen von object.

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

Implementieren Sie diese Funktion neu, sodass sie für jedes von der Implementierung von featureList() zurückgegebene key die Kennung der Ereignisschnittstelle zurückgibt – oder ein leeres QUuid, falls diese Factory den Wert von key nicht unterstützt.

Die Standardimplementierung interpretiert ` key ` als Klassennamen und gibt den Wert des Eintrags „EventsID“ aus ` Q_CLASSINFO()` zurück.

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

Implementieren Sie diese Funktion neu, um den Namen der Oberklasse von ` key ` zurückzugeben, bis zu der Methoden und Eigenschaften vom ActiveX-Steuerelement bereitgestellt werden sollen.

Die Standardimplementierung interpretiert „ key “ als Klassennamen und gibt den Wert des Eintrags „ToSuperClass“ aus der „ Q_CLASSINFO() “ zurück. Ist kein solcher Wert gesetzt, wird die Null-Zeichenkette zurückgegeben, und die Funktionen und Eigenschaften aller Oberklassen einschließlich „ QWidget “ werden freigegeben.

Um nur die Funktionen und Eigenschaften der Klasse selbst verfügbar zu machen, implementieren Sie diese Funktion neu, sodass sie ` key` zurückgibt.

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

Implementieren Sie diese Funktion neu, sodass sie eine Liste der von dieser Factory unterstützten Widgets (Klassennamen) zurückgibt.

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

Implementieren Sie diese Funktion neu, sodass sie „true“ zurückgibt, wenn das ActiveX-Steuerelement „ key “ die Standard-ActiveX-Ereignisse unterstützen soll

• Click
• DblClick
• KeyDown
• KeyPress
• KeyUp
• Maus-Taste gedrückt
• Maus loslassen
• MouseMove

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

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

Implementieren Sie diese Funktion neu, sodass sie für jedes von der Implementierung von ` featureList()` zurückgegebene ` key ` die Schnittstellenkennung zurückgibt – oder ein leeres ` QUuid `, falls diese Factory den Wert von ` key` nicht unterstützt.

Die Standardimplementierung interpretiert ` key ` als Klassennamen und gibt den Wert des Eintrags „InterfaceID“ aus ` Q_CLASSINFO()` 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

Implementieren Sie diese Funktion neu, sodass sie „true“ zurückgibt, wenn der Server als persistenter Dienst (z. B. ein NT-Dienst) ausgeführt wird und auch dann nicht beendet werden soll, wenn alle bereitgestellten Objekte freigegeben wurden.

Die Standardimplementierung gibt „false“ zurück.

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

Implementieren Sie diese Funktion neu, sodass sie die „ QMetaObject “ zurückgibt, die dem Wert „ key “ entspricht, oder den Wert 0, falls diese Factory den Wert „ 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 wird „false“ zurückgegeben. 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 als Reaktion auf eine Anfrage), und nur für ein einziges Objekt, in der Regel das oberste Objekt der Objekthierarchie der Anwendung.

Diese Funktion führt keine Aktion aus und gibt „false“ zurück, wenn die Klasseninformation des Objekts für „RegisterObject“ nicht auf „yes“ gesetzt ist oder wenn es sich bei dem Server um einen In-Process-Server handelt.

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

Registriert zusätzliche Werte für die Klasse „ key “ in der Systemregistrierung mithilfe des Objekts „ settings “. Die Standardwerte wurden bereits vom Framework registriert, doch 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 Registrierungswerte zu entfernen.

Siehe auch QSettings.

[static] QString QAxFactory::serverDirPath()

Gibt das Verzeichnis zurück, in dem sich die Server-Binärdatei befindet.

Bei Out-of-Process-Servern entspricht dies der Funktion „ QCoreApplication::applicationDirPath()“. Bei In-Process-Servern gibt diese Funktion das Verzeichnis zurück, in dem sich die Host-Anwendung befindet.

[static] QString QAxFactory::serverFilePath()

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

Bei Out-of-Process-Servern entspricht dies der Funktion ` QCoreApplication::applicationFilePath()`. Bei In-Process-Servern gibt diese Funktion den Dateipfad der hostenden Anwendung 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“.

Wird diese Funktion aufgerufen, während der Server bereits läuft (oder bei einem In-Process-Server), hat dies keine Auswirkung und es wird „true“ zurückgegeben.

Der Server wird automatisch mit der Einstellung „ type “ auf „ MultipleInstances “ gestartet, 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 Einstiegsfunktion `main()`.

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

Implementieren Sie diese Funktion neu, sodass sie „true“ zurückgibt, wenn das ActiveX-Steuerelement „ key “ ein Fenster der obersten Ebene sein soll, z. B. ein Dialogfeld. Die Standardimplementierung gibt „false“ zurück.

[static] bool QAxFactory::stopServer()

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

Wird diese Funktion aufgerufen, während der Server nicht läuft (oder bei einem In-Process-Server), hat dies keine Auswirkung und es wird „true“ zurückgegeben.

Das Beenden des Servers macht vorhandene Objekte nicht ungültig, es können jedoch keine neuen Objekte aus dem bestehenden Serverprozess heraus erstellt werden. Normalerweise startet COM einen neuen Serverprozess, wenn zusätzliche Objekte angefordert werden.

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

[virtual] QUuid QAxFactory::typeLibID() const

Implementieren Sie diese Funktion neu, damit sie die Typbibliotheks-ID des ActiveX-Servers zurückgibt.

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

Hebt die Registrierung aller zusätzlichen Werte für die Klasse „ key “ in der Systemregistrierung mithilfe des Objekts „ settings “ auf.

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

Implementieren Sie diese Funktion neu, sodass 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“ vorhanden ist), 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.