La herramienta dumpcpp (ActiveQt)
La herramienta « dumpcpp » genera un espacio de nombres C++ para una biblioteca de tipos.
Para generar un espacio de nombres C++ para una biblioteca de tipos, ejecuta dumpcpp con los siguientes parámetros de línea de comandos:
| Opción | Resultado |
|---|---|
| input | Genera documentación para «input». «input» puede especificar un archivo de biblioteca de tipos, un identificador de biblioteca de tipos, un CLSID o un ProgID de un objeto |
| -o archivo | Escribe la declaración de la clase en el archivo file.h y la información del metaobjeto en el archivo file.cpp |
| -n espacio de nombres | Genera un espacio de nombres de C++ «namespace» |
| -nometaobject | No genera un archivo .cpp con la información del metaobjeto. El metaobjeto se genera entonces en tiempo de ejecución. |
| -getfile libid | Muestra el nombre de archivo de la biblioteca de tipos libid en la salida estándar |
| -compat | Genera un espacio de nombres con una API compatible con dynamicCall |
| -controlname | Utiliza el nombre de la clase de control en lugar del UUID en setControl() |
| -v | Mostrar información de la versión |
| -h | Muestra la ayuda |
Por lo general, basta con ejecutar la herramienta manualmente (y quizá incluso incorporar los archivos generados a tu sistema de control de versiones), ya que las bibliotecas de tipos cambian muy raramente. Si tu biblioteca de tipos cambia con frecuencia, puedes integrar dumpcpp en el sistema de compilación qmake. En tu archivo .pro, enumera las bibliotecas de tipos que deseas utilizar en la variable TYPELIBS:
TEMPLATE = app
TARGET = qutlook
QT += widgets axcontainer
TYPELIBS = $$system(dumpcpp -getfile {00062FFF-0000-0000-C000-000000000046})El espacio de nombres generado declarará todas las enumeraciones, así como una subclase « QAxObject » para cada « coclass » y « interface » declarados en la biblioteca de tipos. Las coclases marcadas con el atributo « control » quedarán envueltas por una subclase « QAxWidget ».
Las clases que envuelven coclases creables (es decir, coclases que no están marcadas como noncreatable) tienen un constructor por defecto; normalmente se trata de una única clase de tipo Application.
Outlook::Application *outlook = new Outlook::Application;Todas las demás clases solo pueden crearse pasando un puntero a la interfaz `IDispatch` al constructor; sin embargo, estas clases no deben crearse explícitamente. En su lugar, utilice la API adecuada de los objetos ya creados.
Outlook::_NameSpace *session = outlook->Session();Todos los envoltorios de coclases también tienen un constructor que toma una clase de envoltura de interfaz para cada interfaz implementada.
Outlook::NameSpace *session = outlook->Session();Debes crear coclases para poder conectarte a las señales del subobjeto. Ten en cuenta que el constructor elimina el objeto de interfaz, por lo que lo siguiente provocará un error de segmentación:
Outlook::_NameSpace *tmp = outlook->Session();
Outlook::NameSpace *session = new Outlook::NameSpace(tmp);
delete tmp; // or any other use of tmp: segfaultSi el tipo de retorno es de una coclase o un tipo de interfaz declarado en otra biblioteca de tipos, debes incluir el encabezado del espacio de nombres de esa otra biblioteca de tipos antes de incluir el encabezado del espacio de nombres que deseas utilizar (ambos encabezados deben generarse con esta herramienta).
Por defecto, los métodos y propiedades que devuelven subobjetos utilizarán el tipo tal y como aparece en la biblioteca de tipos. Quien invoca la función es responsable de eliminar o reasignar el padre del objeto devuelto. Si se activa la opción « -compat », las propiedades y los métodos que devuelven un objeto COM tendrán como tipo de retorno « IDispatch* », y el espacio de nombres no declarará clases envolventes para las interfaces.
En este caso, crea explícitamente la clase envolventa correcta:
Outlook::NameSpace *session = new Outlook::NameSpace(outlook->Session());Por supuesto, puede utilizar directamente el IDispatch* devuelto; en ese caso, deberá llamar a Release() cuando haya terminado de utilizar la interfaz.
Todas las clases del espacio de nombres están etiquetadas con una macro que permite exportarlas o importarlas desde una DLL. Para ello, declare la macro para que se expanda a __declspec(dllimport/export) antes de incluir el archivo de cabecera.
Para compilar la herramienta, primero debe compilar la biblioteca QAxContainer. A continuación, ejecute su herramienta «make» en tools/dumpcpp.
© 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.