QAxObject Class
La clase QAxObject proporciona un objeto de tipo « QObject » que envuelve un objeto COM. Más información...
| Encabezado: | #include <qaxobject.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS AxContainer) target_link_libraries(mytarget PRIVATE Qt6::AxContainer) |
| qmake: | QT += axcontainer |
| Heredado de: | QAxBaseObject y QAxBase |
| Heredado por: |
Funciones públicas
| 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) |
Funciones protegidas reimplementadas
| virtual void | connectNotify(const QMetaMethod &signal) override |
Descripción detallada
Un QAxObject puede instanciarse como un objeto vacío, con el nombre del objeto COM que debe envolver, o con un puntero a IUnknown que represente un objeto COM existente. Si el objeto COM implementa la interfaz IDispatch, las propiedades, los métodos y los eventos de dicho objeto pasan a estar disponibles como propiedades, ranuras y señales de Qt. La clase base, QAxBase, proporciona una API para acceder al objeto COM directamente a través del puntero IUnknown.
QAxObject es un QObject y puede utilizarse como tal; por ejemplo, puede organizarse en una jerarquía de objetos, recibir eventos y conectarse a señales y ranuras.
QAxObject también hereda la mayor parte de su funcionalidad relacionada con ActiveX de ` QAxBase`, en particular ` dynamicCall()` y ` querySubObject()`.
Advertencia: Se puede crear una subclase de QAxObject, pero no se puede utilizar la macro Q_OBJECT en la subclase (el archivo moc generado no se compilará), por lo que no se pueden añadir más señales, ranuras ni propiedades. Esta limitación se debe a la información de metaobjetos generada en tiempo de ejecución. Para solucionar este problema, agrega el QAxObject como miembro de la subclase QObject.
Véase también QAxBase, QAxWidget, QAxScript y ActiveQt Framework.
Documentación de las funciones de miembro
[explicit] QAxObject::QAxObject(QObject *parent = nullptr)
Crea un objeto COM vacío y pasa ` parent ` al constructor ` QObject `. Para inicializar el objeto, llama a `setControl()`.
Véase también setControl().
[explicit] QAxObject::QAxObject(IUnknown *iface, QObject *parent = nullptr)
Crea un QAxObject que envuelve el objeto COM al que hace referencia iface. parent se transmite al constructor QObject.
[explicit] QAxObject::QAxObject(const QString &c, QObject *parent = nullptr)
Crea un QAxObject que envuelve el objeto COM c. El valor de « parent » se transmite al constructor de QObject.
Véase también setControl().
[override virtual noexcept] QAxObject::~QAxObject()
Libera el objeto COM y destruye el ` QAxObject`, liberando todos los recursos asignados.
[override virtual protected] void QAxObject::connectNotify(const QMetaMethod &signal)
Reimplementa: QObject::connectNotify(const QMetaMethod &signal).
bool QAxObject::doVerb(const QString &verb)
Solicita al objeto COM que realice la acción « verb ». Los verbos posibles se obtienen mediante la función « verbs()».
La función devuelve «true» si el objeto ha podido realizar la acción; en caso contrario, devuelve «false».
© 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.