QAxFactory Class

Documentation des fonctions membres

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

Construit un objet QAxFactory qui renvoie libid et appid dans l'implémentation des fonctions d'interface respectives.

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

Détruit l'objet QAxFactory.

[virtual] QUuid QAxFactory::appID() const

Réimplémenter cette fonction pour renvoyer l'identifiant de l'application du serveur ActiveX.

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

Réimplémenter cette fonction pour renvoyer l'identifiant de la classe pour chaque key renvoyé par l'implémentation featureList(), ou un QUuid vide si cette fabrique ne prend pas en charge la valeur de key.

L'implémentation par défaut interprète key comme le nom de la classe et renvoie la valeur de l'entrée "ClassID" de Q_CLASSINFO().

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

Réimplémenter cette fonction pour renvoyer un nouvel objet pour key, ou 0 si cette fabrique ne prend pas en charge la valeur de key.

Si l'objet renvoyé est un QWidget, il sera exposé comme un contrôle ActiveX, sinon l'objet renvoyé sera exposé comme un simple objet COM.

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

Réimplémenter cette fonction pour fournir l'objet COM pour object dans wrapper. Elle renvoie true si la fonction a réussi ; sinon, elle renvoie false.

L'implémentation par défaut crée une enveloppe d'automatisation générique basée sur les méta-informations d'objet de object.

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

Réimplémenter cette fonction pour renvoyer l'identifiant de l'interface d'événement pour chaque key renvoyé par l'implémentation featureList(), ou un QUuid vide si cette fabrique ne prend pas en charge la valeur de key.

L'implémentation par défaut interprète key comme le nom de la classe et renvoie la valeur de l'entrée "EventsID" de Q_CLASSINFO().

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

Réimplémenter cette fonction pour renvoyer le nom de la super-classe de key jusqu'à laquelle les méthodes et les propriétés doivent être exposées par le contrôle ActiveX.

L'implémentation par défaut interprète key comme le nom de la classe et renvoie la valeur de l'entrée "ToSuperClass" de Q_CLASSINFO(). Si cette valeur n'est pas définie, la chaîne nulle est renvoyée et les fonctions et propriétés de toutes les superclasses, y compris QWidget, sont exposées.

Pour n'exposer que les fonctions et propriétés de la classe elle-même, réimplémentez cette fonction pour qu'elle renvoie key.

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

Réimplémenter cette fonction pour renvoyer une liste des widgets (noms de classes) pris en charge par cette fabrique.

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

Réimplémentez cette fonction pour qu'elle renvoie un message vrai si le contrôle ActiveX key doit prendre en charge les événements ActiveX standard.

• Clic
• DblClick
• Touche enfoncée
• Appui sur le clavier
• ToucheUp
• Souris vers le bas
• SourisUp
• Déplacement de la souris

L'implémentation par défaut interprète key comme le nom de la classe et renvoie la valeur "true" si la valeur de l'entrée "StockEvents" de Q_CLASSINFO() est "yes". Dans le cas contraire, cette fonction renvoie la valeur false.

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

Réimplémenter cette fonction pour renvoyer l'identifiant d'interface pour chaque key renvoyé par l'implémentation featureList(), ou un QUuid vide si cette fabrique ne prend pas en charge la valeur de key.

L'implémentation par défaut interprète key comme le nom de la classe et renvoie la valeur de l'entrée "InterfaceID" de Q_CLASSINFO().

[static] bool QAxFactory::isServer()

Retourne true si l'application a été démarrée (par COM) en tant que serveur ActiveX, sinon retourne false.

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

Réimplémentez cette fonction pour qu'elle renvoie true si le serveur fonctionne comme un service persistant (par exemple, un service NT) et ne doit pas se terminer même si tous les objets fournis ont été libérés.

L'implémentation par défaut renvoie false.

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

Réimplémenter cette fonction pour renvoyer la valeur QMetaObject correspondant à key, ou 0 si cette fabrique ne prend pas en charge la valeur de key.

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

Enregistre l'objet QObject object auprès de COM en tant qu'objet en cours d'exécution et renvoie true si l'enregistrement a réussi, sinon il renvoie false. L'objet est automatiquement désenregistré lorsqu'il est détruit.

Cette fonction ne doit être appelée que si l'application a été lancée par l'utilisateur (c'est-à-dire pas par COM pour répondre à une demande), et seulement pour un objet, généralement l'objet de premier niveau de la hiérarchie des objets de l'application.

Cette fonction ne fait rien et renvoie un message faux si l'information de classe de l'objet pour "RegisterObject" n'est pas définie sur "yes", ou si le serveur est un serveur en cours de traitement.

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

Enregistre des valeurs supplémentaires pour la classe key dans le registre du système à l'aide de l'objet settings. Les valeurs standard ont déjà été enregistrées par le cadre, mais des valeurs supplémentaires, par exemple des catégories implémentées, peuvent être ajoutées dans une implémentation de cette fonction.

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

Si vous réimplémentez cette fonction, vous devez également réimplémenter unregisterClass() pour supprimer les valeurs supplémentaires du registre.

Voir également QSettings.

[static] QString QAxFactory::serverDirPath()

Renvoie le répertoire qui contient le binaire du serveur.

Pour les serveurs hors processus, c'est la même chose que QCoreApplication::applicationDirPath(). Pour les serveurs en cours de traitement, cette fonction renvoie le répertoire qui contient l'application d'hébergement.

[static] QString QAxFactory::serverFilePath()

Renvoie le chemin d'accès au fichier binaire du serveur.

Pour les serveurs hors processus, c'est la même chose que QCoreApplication::applicationFilePath(). Pour les serveurs en cours de traitement, cette fonction renvoie le chemin d'accès au fichier de l'application hôte.

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

Démarre le serveur COM avec type et renvoie true en cas de succès, sinon renvoie false.

L'appel de cette fonction si le serveur est déjà en cours d'exécution (ou pour un serveur en cours d'exécution) ne fait rien et renvoie true.

Le serveur est démarré automatiquement avec type défini sur MultipleInstances si l'exécutable du serveur a été démarré avec le paramètre de ligne de commande -activex. Pour passer à SingleInstance, appelez

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

dans votre propre fonction de point d'entrée main().

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

Réimplémentez cette fonction pour qu'elle renvoie true si le contrôle ActiveX key doit être une fenêtre de premier niveau, par exemple une boîte de dialogue. L'implémentation par défaut renvoie false.

[static] bool QAxFactory::stopServer()

Arrête le serveur COM et renvoie true en cas de succès, sinon renvoie false.

L'appel à cette fonction si le serveur n'est pas en cours d'exécution (ou pour un serveur en cours d'exécution) ne fait rien et renvoie true.

L'arrêt du serveur n'invalide pas les objets existants, mais aucun nouvel objet ne peut être créé à partir du processus serveur existant. En général, COM lance un nouveau processus serveur si des objets supplémentaires sont demandés.

Le serveur est arrêté automatiquement lorsque la fonction main() est renvoyée.

[virtual] QUuid QAxFactory::typeLibID() const

Réimplémenter cette fonction pour renvoyer l'identifiant de la bibliothèque de types du serveur ActiveX.

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

Désenregistre toutes les valeurs supplémentaires de la classe key dans le registre du système à l'aide de l'objet settings.

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

Voir également registerClass() et QSettings.

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

Réimplémentez cette fonction pour qu'elle renvoie un message vrai si licenseKey est une licence valide pour la classe key, ou si la machine actuelle dispose d'une licence.

L'implémentation par défaut renvoie vrai si la classe key n'est pas sous licence (c'est-à-dire pas d'attribut Q_CLASSINFO() "LicenseKey"), ou si licenseKey correspond à la valeur de l'attribut "LicenseKey", ou si la machine est sous licence par le biais d'un fichier .LIC portant le même nom de fichier que ce serveur COM.