Ejemplo de aplicación COM (ActiveQt)
El ejemplo de aplicación COM muestra cómo utilizar ActiveQt para desarrollar una aplicación Qt que se pueda automatizar a través de COM. Se exponen diferentes clases basadas en QObject como objetos COM que se comunican con la interfaz gráfica de usuario (GUI) de la aplicación Qt en ejecución. Las API de dichos objetos COM se han diseñado para que se asemejen a las API de las aplicaciones COM estándar; es decir, las de Microsoft Office.
class Application : public QObject
{
Q_OBJECT
Q_CLASSINFO("ClassID", "{b50a71db-c4a7-4551-8d14-49983566afee}")
Q_CLASSINFO("InterfaceID", "{4a427759-16ef-4ed8-be79-59ffe5789042}")
Q_CLASSINFO("RegisterObject", "yes")
Q_PROPERTY(DocumentList* documents READ documents)
Q_PROPERTY(QString id READ id)
Q_PROPERTY(bool visible READ isVisible WRITE setVisible)
public:
explicit Application(QObject *parent = nullptr);
DocumentList *documents() const;
QString id() const { return objectName(); }
void setVisible(bool on);
bool isVisible() const;
QTabWidget *window() const { return m_ui.data(); }
public slots:
void quit();
private:
QScopedPointer <DocumentList> m_docs;
QScopedPointer <QTabWidget> m_ui;
};La primera clase, ` Application `, representa el objeto de la aplicación. Expone las propiedades de solo lectura ` documents ` y ` id ` para acceder a la lista de documentos, así como un identificador. Una propiedad de lectura/escritura, ` visible `, controla si la interfaz de usuario de la aplicación basada en ` QTabWidget` debe estar visible, y una ranura, ` quit() `, cierra la aplicación.
El atributo RegisterObject se configura para garantizar que las instancias de esta clase se registren en la tabla de objetos en ejecución (ROT) de COM; esto permite a los clientes COM conectarse a un objeto COM ya instanciado.
class DocumentList : public QObject
{
Q_OBJECT
Q_CLASSINFO("ClassID", "{496b761d-924b-4554-a18a-8f3704d2a9a6}")
Q_CLASSINFO("InterfaceID", "{6c9e30e8-3ff6-4e6a-9edc-d219d074a148}")
Q_PROPERTY(Application* application READ application)
Q_PROPERTY(int count READ count)
public:
explicit DocumentList(Application *application);
int count() const;
Application *application() const;
public slots:
Document *addDocument();
Document *item(int index) const;
private:
QList<Document *> m_list;
};La clase ` DocumentList ` almacena una lista de documentos. Proporciona una API para leer el número de documentos, acceder a cada documento por índice y crear un nuevo documento. La propiedad ` application ` devuelve el objeto raíz.
class Document : public QObject
{
Q_OBJECT
Q_CLASSINFO("ClassID", "{2b5775cd-72c2-43da-bc3b-b0e8d1e1c4f7}")
Q_CLASSINFO("InterfaceID", "{2ce1761e-07a3-415c-bd11-0eab2c7283de}")
Q_PROPERTY(Application *application READ application)
Q_PROPERTY(QString title READ title WRITE setTitle)
public:
explicit Document(DocumentList *list);
virtual ~Document();
Application *application() const;
QString title() const;
void setTitle(const QString &title);
private:
QScopedPointer <QWidget> m_page;
};Por último, la clase ` Document ` representa un documento en la aplicación. Cada documento está representado por una página en el control de pestañas de la aplicación y tiene un título que se puede leer y escribir a través de la API del documento. La propiedad ` application ` devuelve, de nuevo, el objeto raíz.
Document::Document(DocumentList *list)
: QObject(list)
{
QTabWidget *tabs = list->application()->window();
m_page.reset(new QWidget(tabs));
m_page->setWindowTitle(tr("Unnamed"));
tabs->addTab(m_page.data(), m_page->windowTitle());
m_page->show();
}
Document::~Document() = default;
Application *Document::application() const
{
return qobject_cast<DocumentList *>(parent())->application();
}
QString Document::title() const
{
return m_page->windowTitle();
}
void Document::setTitle(const QString &t)
{
m_page->setWindowTitle(t);
QTabWidget *tabs = application()->window();
int index = tabs->indexOf(m_page.data());
tabs->setTabText(index, m_page->windowTitle());
}La implementación de la clase ` Document ` crea una nueva página para el widget de pestañas y utiliza el título de esa página como propiedad `title`. La página se elimina cuando se elimina el documento.
DocumentList::DocumentList(Application *application)
: QObject(application)
{
}
Application *DocumentList::application() const
{
return qobject_cast<Application *>(parent());
}
int DocumentList::count() const
{
return m_list.size();
}
Document *DocumentList::item(int index) const
{
return m_list.value(index, nullptr);
}
Document *DocumentList::addDocument()
{
Document *document = new Document(this);
m_list.append(document);
return document;
}La implementación de ` DocumentList ` es sencilla.
Application::Application(QObject *parent)
: QObject(parent),
m_ui(new QTabWidget),
m_docs(new DocumentList(this))
{
setObjectName(QStringLiteral("From QAxFactory"));
}
DocumentList *Application::documents() const
{
return m_docs.data();
}
void Application::setVisible(bool on)
{
m_ui->setVisible(on);
}
bool Application::isVisible() const
{
return m_ui->isVisible();
}
void Application::quit()
{
m_docs.reset();
m_ui.reset();
QTimer::singleShot(0 /*ms*/, qApp, &QCoreApplication::quit);
}
#include "main.moc"La clase ` Application ` inicializa la interfaz de usuario en el constructor y la muestra y oculta en la implementación de ` setVisible()`. El nombre del objeto (accesible a través de la propiedad ` id `) se establece en ` "From QAxFactory ` para indicar que este objeto COM ha sido creado por COM. Tenga en cuenta que no hay ningún destructor que elimine el QTabWidget; esto se realiza, en su lugar, en el slot quit(), antes de llamar a quit() mediante un temporizador de un solo disparo, lo cual es necesario para garantizar que la llamada COM al slot se complete.
QAXFACTORY_BEGIN("{edd3e836-f537-4c6f-be7d-6014c155cc7a}", "{b7da3de8-83bb-4bbe-9ab7-99a05819e201}")
QAXCLASS(Application)
QAXTYPE(Document)
QAXTYPE(DocumentList)
QAXFACTORY_END()Las clases se exportan desde el servidor mediante las macros QAxFactory. Solo se pueden instanciar objetos Application desde el exterior; las demás API solo se pueden utilizar tras acceder a los objetos correspondientes a través de la API Application.
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
app.setQuitOnLastWindowClosed(false);
// started by COM - don't do anything
if (QAxFactory::isServer())
return app.exec();
// started by user
Application appobject;
appobject.setObjectName(QStringLiteral("From Application"));
QAxFactory::startServer();
QAxFactory::registerActiveObject(&appobject);
appobject.window()->setMinimumSize(300, 100);
appobject.setVisible(true);
QObject::connect(&app, &QGuiApplication::lastWindowClosed, &appobject, &Application::quit);
return app.exec();
}La función de punto de entrada main() crea un ` QApplication` y, si la aplicación ha sido iniciada por COM, simplemente entra en el bucle de eventos. Si la aplicación ha sido iniciada por el usuario, se crea el objeto ` Application ` y se establece el nombre del objeto como «From Application». A continuación, se inicia el servidor COM y se registra el objeto de la aplicación en COM. Ahora los clientes COM pueden acceder a él a través de las API específicas de cada cliente.
La salida de la aplicación se controla de forma explícita: si COM ha iniciado la aplicación, el código del cliente debe llamar a `quit()`; si el usuario ha iniciado la aplicación, esta finaliza cuando se ha cerrado la última ventana.
Por último, se muestra la interfaz de usuario y se inicia el bucle de eventos.
Ahora, una sencilla aplicación de Visual Basic podría acceder a esta aplicación Qt. En VB, inicia un nuevo proyecto «Standard Exe» y añade una referencia de proyecto a la biblioteca de tipos comappLib. Crea un formulario con un cuadro de lista «DocumentList», una etiqueta estática «DocumentsCount» y un botón de comando «NewDocument». Por último, implementa el código del formulario de la siguiente manera:
Private Application As comappLib.Application
Private MyApp As Boolean
Private Sub UpdateList()
DocumentList.Clear
DocumentsCount.Caption = Application.documents.Count
For Index = 0 To Application.documents.Count - 1
DocumentList.AddItem (Application.documents.Item(Index).Title)
Next
End Sub
Private Sub Form_Load()
On Error GoTo CreateNew
Set Application = GetObject(, "comapp.Application")
MyApp = False
GoTo Initialized
CreateNew:
On Error GoTo InitializeFailed
Set Application = New Application
Application.Visible = True
MyApp = True
Initialized:
Caption = Application.id
UpdateList
InitializeFailed:
End Sub
Private Sub Form_Unload(Cancel As Integer)
If MyApp Then
Application.quit
End If
End Sub
Private Sub NewDocument_Click()
Application.documents.addDocument
UpdateList
End SubPara compilar el ejemplo, primero debes compilar la biblioteca QAxServer. A continuación, ejecuta qmake y tu herramienta de compilación en examples\activeqt\comapp.
© 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.