Uso de controles ActiveX y COM en Qt
El módulo « QAxContainer » forma parte del marco ActiveQt. Proporciona una biblioteca que implementa una subclase de « QWidget », QAxWidget, que actúa como contenedor de controles ActiveX, y una subclase de « QObject », QAxObject, que puede utilizarse para acceder fácilmente a objetos COM no visuales. Es posible crear scripts para objetos COM incrustados mediante estas clases a través de las clases QAxScript, QAxScriptManager y QAxScriptEngine, y un conjunto de herramientas facilita el acceso a los objetos COM mediante programación.
El módulo consta de seis clases
- QAxBase es una clase abstracta que proporciona una API para inicializar y acceder a un objeto COM o a un control ActiveX.
- QAxObject Proporciona un objeto de tipo « QObject » que envuelve un objeto COM.
- QAxWidget es un « QWidget » que envuelve un control ActiveX.
- QAxScriptManager, ` QAxScript ` y ` QAxScriptEngine ` proporcionan una interfaz para Windows Script Host.
Se proporcionan algunos ejemplos de aplicaciones que utilizan controles ActiveX estándar para ofrecer funcionalidades de interfaz de usuario de alto nivel.
Uso de la biblioteca
Para compilar aplicaciones Qt que puedan alojar objetos COM y controles ActiveX, enlaza la aplicación con el módulo ` QAxContainer ` añadiendo
QT += axcontaineral archivo ` .pro ` de su aplicación.
Distribución de aplicaciones QAxContainer
La biblioteca QAxContainer es estática, por lo que no es necesario redistribuir ningún archivo adicional al utilizar este módulo. Sin embargo, ten en cuenta que es posible que los binarios del servidor ActiveX que estés utilizando no estén instalados en el sistema de destino, por lo que deberás incluirlos en tu paquete y registrarlos durante el proceso de instalación de tu aplicación.
Instanciación de objetos COM
Para instanciar un objeto COM, utiliza la API QAxBase::setControl() o pasa el nombre del objeto directamente al constructor de la subclase de QAxBase que estés utilizando.
El control se puede especificar en diversos formatos, pero el más rápido y potente es utilizar directamente el identificador de clase (CLSID) del objeto. Al identificador de clase se le puede anteponer información sobre el equipo remoto en el que debe ejecutarse el objeto, y puede incluir una clave de licencia para los controles con licencia.
Mensajes de error habituales
ActiveQt muestra mensajes de error en la salida de depuración cuando se produce un error en tiempo de ejecución. Por lo general, debe ejecutar el programa en el depurador para ver estos mensajes (por ejemplo, en la salida de depuración de Visual Studio).
No se ha podido instanciar el control solicitado
El control solicitado en QAxBase::setControl() no está instalado en este sistema o no es accesible para el usuario actual.
Es posible que el control requiera derechos de administrador o una clave de licencia. Si el control está protegido por licencia, pasa la clave de licencia a QAxBase::setControl tal y como se indica en la documentación.
Acceso a la API de objetos
ActiveQt proporciona una API de Qt para el objeto COM y sustituye los tipos de datos COM por sus equivalentes en Qt.
Hay cuatro formas de llamar a las API del objeto COM:
- Generar un espacio de nombres de C++
- Llamada por nombre
- A través de un motor de scripts
- Utilizando las interfaces COM nativas
Generación de un espacio de nombres de C++
Para generar un espacio de nombres de C++ para la biblioteca de tipos a la que desea acceder, utilice la herramienta dumpcpp. Ejecute esta herramienta manualmente en la biblioteca de tipos que desee utilizar, o intégrela en el sistema de compilación añadiendo las bibliotecas de tipos a la variable ` TYPELIBS ` en el archivo ` .pro ` de su aplicación:
TYPELIBS = file.tlbTen en cuenta que es posible que dumpcpp no pueda exponer todas las API de la biblioteca de tipos.
Incluye el archivo de cabecera resultante en tu código para acceder a las API de objetos a través de las clases C++ generadas. Consulta el ejemplo de Qutlook para obtener más información.
Llamada por nombre
Utiliza QAxBase::dynamicCall() y QAxBase::querySubObject(), así como las API QObject::setProperty() y QObject::property(), para llamar a los métodos y propiedades del objeto COM mediante su nombre. Utiliza la herramienta dumpdoc para obtener la documentación de la API de Qt para cualquier objeto COM y sus subobjetos; ten en cuenta que es posible que no estén disponibles todas las API del objeto COM.
Llamada a funciones a través de un motor de scripts
Una aplicación Qt puede alojar cualquier motor ActiveScript instalado en el sistema. El motor de scripts puede entonces ejecutar código de script que acceda a los objetos COM.
Para instanciar un motor de scripts, utiliza QAxScriptManager::addObject() para registrar los objetos COM a los que deseas acceder desde el script, y QAxScriptManager::load() para cargar el código de script en el motor. A continuación, llama a las funciones de script utilizando QAxScriptManager::call() o QAxScript::call().
Las API del objeto COM disponibles mediante scripts dependen del lenguaje de script utilizado.
El contenedor de pruebas de ActiveX muestra cómo se cargan los archivos de script.
Llamada a una función mediante las interfaces COM nativas
Para llamar a funciones del objeto COM a las que no se puede acceder mediante ninguno de los métodos anteriores, es posible solicitar la interfaz COM directamente mediante QAxBase::queryInterface(). Para obtener una definición en C++ de las clases de interfaz correspondientes, utiliza la directiva #import con la biblioteca de tipos proporcionada con el control; consulta el manual de tu compilador para obtener más detalles.
Mensajes de error habituales
ActiveQt muestra mensajes de error en la salida de depuración cuando se produce un error en tiempo de ejecución. Por lo general, debe ejecutar el programa en el depurador para ver estos mensajes (por ejemplo, en la salida de depuración de Visual Studio).
QAxBase::internalInvoke: No existe ese método
Se ha producido un error en QAxBase::dynamicCall() — el prototipo de la función no coincidía con ninguna función disponible en la API del objeto.
Error al llamar al miembro IDispatch: falta un parámetro obligatorio
Ha fallado una llamada a QAxBase::dynamicCall(): el prototipo de la función era correcto, pero se han proporcionado muy pocos parámetros.
Error al llamar al miembro IDispatch: discrepancia de tipos en el parámetro n
Se ha producido un error en QAxBase::dynamicCall(): el prototipo de la función era correcto, pero el parámetro en el índice n era de un tipo incorrecto y no se pudo convertir al tipo correcto.
QAxScriptManager::call(): Ningún script proporciona esta función
Intentas llamar a una función que se proporciona a través de un motor que no admite introspección (por ejemplo, ActivePython o ActivePerl). Debes llamar a la función directamente en el objeto QAxScript correspondiente.
Véase también el marco ActiveQt.
© 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.