QAxFactory Class

Documentation des fonctions membres

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

Crée un objet QAxFactory qui renvoie « libid » et « appid » lors de l'implémentation des fonctions respectives de l'interface.

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

Supprime l'objet « QAxFactory ».

[virtual] QUuid QAxFactory::appID() const

Réimplémentez cette fonction afin qu'elle renvoie l'identifiant d'application du serveur ActiveX.

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

Réimplémentez cette fonction pour renvoyer l'identifiant de classe correspondant à chaque key renvoyé par l'implémentation de 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émentez cette fonction pour renvoyer un nouvel objet de type ` key`, ou 0 si cette fabrique ne prend pas en charge la valeur ` key`.

Si l'objet renvoyé est un ` QWidget `, il sera exposé en tant que contrôle ActiveX ; dans le cas contraire, l'objet renvoyé sera exposé en tant qu'objet COM simple.

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

Réimplémentez cette fonction afin de fournir l'objet COM correspondant à object dans wrapper. Renvoyez « true » si la fonction s'est déroulée avec succès ; sinon, renvoyez « false ».

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

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

Réimplémentez cette fonction pour renvoyer l'identifiant de l'interface d'événement pour chaque key renvoyé par l'implémentation de featureList(), ou une 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émentez cette fonction pour renvoyer le nom de la superclasse 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 la base de données Q_CLASSINFO(). Si aucune valeur n'est définie, une chaîne vide est renvoyée et les fonctions et propriétés de toutes les superclasses, y compris QWidget, seront exposées.

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

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

Réimplémentez cette fonction pour qu'elle renvoie 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 « true » si le contrôle ActiveX key doit prendre en charge les événements ActiveX standard

• Click
• DblClick
• KeyDown
• KeyPress
• KeyUp
• Clic de souris
• MouseUp
• MouseMove

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

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

Réimplémentez cette fonction afin qu’elle renvoie l’identifiant d’interface correspondant à chaque key renvoyé par l’implémentation de 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 la fonction Q_CLASSINFO().

[static] bool QAxFactory::isServer()

Renvoie « true » si l'application a été lancée (par COM) en tant que serveur ActiveX ; sinon, renvoie « 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 s'exécute en tant que service persistant (par exemple, un service NT) et ne doit pas s'arrêter même lorsque 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émentez cette fonction pour qu'elle renvoie l'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'QObject e object auprès de COM en tant qu'objet actif, et renvoie « true » si l'enregistrement a réussi, sinon « 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 non pas par COM en réponse à une requête), et uniquement pour un seul objet, généralement l’objet de niveau supérieur de la hiérarchie d’objets de l’application.

Cette fonction ne fait rien et renvoie « false » 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 système à l'aide de l'objet ` settings `. Les valeurs par défaut ont déjà été enregistrées par le framework, 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() afin de supprimer les valeurs supplémentaires du registre.

Voir également QSettings.

[static] QString QAxFactory::serverDirPath()

Renvoie le répertoire contenant le binaire du serveur.

Pour les serveurs hors processus, cela revient à appeler la fonction ` QCoreApplication::applicationDirPath()`. Pour les serveurs en processus, cette fonction renvoie le répertoire contenant l'application hôte.

[static] QString QAxFactory::serverFilePath()

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

Pour les serveurs hors processus, cela revient à appeler la fonction ` QCoreApplication::applicationFilePath()`. Pour les serveurs en processus, cette fonction renvoie le chemin d'accès au fichier de l'application hôte.

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

Lance le serveur COM à l'adresse type et renvoie « true » en cas de succès, sinon « false ».

L'appel de cette fonction alors que le serveur est déjà en cours d'exécution (ou pour un serveur en cours de traitement) n'a aucun effet et renvoie « true ».

Le serveur est lancé automatiquement avec type défini sur MultipleInstances si l'exécutable du serveur a été lancé 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 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 réussite, sinon « false ».

L'appel de cette fonction alors que le serveur n'est pas en cours d'exécution (ou dans le cas d'un serveur en cours de traitement) n'a aucun effet 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() se termine.

[virtual] QUuid QAxFactory::typeLibID() const

Réimplémentez cette fonction afin qu'elle renvoie l'identifiant de la bibliothèque de types du serveur ActiveX.

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

Supprime toutes les entrées supplémentaires associées à la classe « key » du registre 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 `true` 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 « true » si la classe key n'est pas sous licence (c'est-à-dire si elle ne possède pas d'attribut « LicenseKey » de type Q_CLASSINFO() ), ou si licenseKey correspond à la valeur de l'attribut « LicenseKey », ou encore si la machine est sous licence via un fichier .LIC portant le même nom que ce serveur COM.