En esta página

QAxObject Class

La clase QAxObject proporciona un QObject que envuelve un objeto COM. Más...

Cabecera: #include <QAxObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS AxContainer)
target_link_libraries(mytarget PRIVATE Qt6::AxContainer)
qmake: QT += axcontainer
Hereda: QAxBaseObject y QAxBase
Heredado por:

QAxScriptEngine

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 al IUnknown que representa un objeto COM existente. Si el objeto COM implementa la interfaz IDispatch, las propiedades, métodos y eventos de ese objeto estarán 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, especialmente de dynamicCall() y querySubObject().

Advertencia: Puedes subclasificar QAxObject, pero no puedes utilizar la macro Q_OBJECT en la subclase (el archivo moc generado no compilará), por lo que no podrás añadir más señales, ranuras o propiedades. Esta limitación se debe a la información del metaobjeto generada en tiempo de ejecución. Para solucionar este problema, agregue el QAxObject como miembro de la subclase QObject.

Véase también QAxBase, QAxWidget, QAxScript, y ActiveQt Framework.

Documentación de funciones miembro

[explicit] QAxObject::QAxObject(QObject *parent = nullptr)

Crea un objeto COM vacío y propaga 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 referenciado por iface. parent se propaga al constructor QObject.

[explicit] QAxObject::QAxObject(const QString &c, QObject *parent = nullptr)

Crea un QAxObject que envuelve al objeto COM c. parent se propaga al constructor QObject.

Véase también setControl().

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

Libera el objeto COM y destruye la página QAxObject, limpiando 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 posibles verbos son devueltos por verbs().

La función devuelve true si el objeto puede 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.