QAxObject Class
La classe QAxObject fournit un QObject qui enveloppe un objet COM. Plus d'informations...
| En-tête : | #include <QAxObject> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS AxContainer)target_link_libraries(mytarget PRIVATE Qt6::AxContainer) |
| qmake : | QT += axcontainer |
| Hérite : | QAxBaseObject et QAxBase |
| Hérité par : |
Fonctions publiques
| QAxObject(QObject *parent = nullptr) | |
| QAxObject(IUnknown *iface, QObject *parent = nullptr) | |
| QAxObject(const QString &c, QObject *parent = nullptr) | |
| virtual | ~QAxObject() override |
| bool | doVerb(const QString &verb) |
Fonctions protégées réimplémentées
| virtual void | connectNotify(const QMetaMethod &signal) override |
Description détaillée
Un QAxObject peut être instancié en tant qu'objet vide, avec le nom de l'objet COM qu'il doit envelopper, ou avec un pointeur sur l'IUnknown qui représente un objet COM existant. Si l'objet COM met en œuvre l'interface IDispatch, les propriétés, méthodes et événements de cet objet deviennent disponibles en tant que propriétés, slots et signaux Qt. La classe de base, QAxBase, fournit une API permettant d'accéder directement à l'objet COM par le biais du pointeur IUnknown.
QAxObject est un QObject et peut être utilisé comme tel, c'est-à-dire qu'il peut être organisé dans une hiérarchie d'objets, recevoir des événements et se connecter à des signaux et à des emplacements.
QAxObject hérite également de la plupart des fonctionnalités liées à ActiveX de QAxBase, notamment dynamicCall() et querySubObject().
Attention : Vous pouvez sous-classer QAxObject, mais vous ne pouvez pas utiliser la macro Q_OBJECT dans la sous-classe (le fichier moc généré ne se compilera pas), de sorte que vous ne pouvez pas ajouter d'autres signaux, slots ou propriétés. Cette limitation est due aux informations sur le métaobjet générées lors de l'exécution. Pour contourner ce problème, il faut agréger le QAxObject en tant que membre de la sous-classe QObject.
Voir également QAxBase, QAxWidget, QAxScript, et ActiveQt Framework.
Documentation des fonctions membres
[explicit] QAxObject::QAxObject(QObject *parent = nullptr)
Crée un objet COM vide et transmet parent au constructeur QObject. Pour initialiser l'objet, appelez setControl().
Voir aussi setControl().
[explicit] QAxObject::QAxObject(IUnknown *iface, QObject *parent = nullptr)
Crée un QAxObject qui enveloppe l'objet COM référencé par iface. parent est propagé au constructeur de QObject.
[explicit] QAxObject::QAxObject(const QString &c, QObject *parent = nullptr)
Crée un QAxObject qui enveloppe l'objet COM c. parent est propagé dans le constructeur QObject.
Voir aussi setControl().
[override virtual noexcept] QAxObject::~QAxObject()
Libère l'objet COM et détruit le site QAxObject, en nettoyant toutes les ressources allouées.
[override virtual protected] void QAxObject::connectNotify(const QMetaMethod &signal)
Réimplémente : QObject::connectNotify(const QMetaMethod &signal).
bool QAxObject::doVerb(const QString &verb)
Demande à l'objet COM d'effectuer l'action verb. Les verbes possibles sont renvoyés par verbs().
La fonction renvoie un résultat vrai si l'objet peut effectuer l'action, sinon elle renvoie un résultat faux.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
