QAxAggregated Class
La clase QAxAggregated es una clase base abstracta para la implementación de interfaces COM adicionales. Más información...
| Encabezado: | #include <qaxaggregated.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS AxServer) target_link_libraries(mytarget PRIVATE Qt6::AxServer) |
| qmake: | QT += axserver |
Funciones públicas
| virtual long | queryInterface(const QUuid &iid, void **iface) = 0 |
Funciones protegidas
| QAxAggregated() | |
| virtual | ~QAxAggregated() |
| IUnknown * | controllingUnknown() const |
| QObject * | object() const |
| QWidget * | widget() const |
Descripción detallada
Crea una subclase de QAxAggregated y reimplementa queryInterface() para admitir interfaces COM adicionales. Utiliza la herencia múltiple de dichas interfaces COM. Implementa la interfaz IUnknown de dichas interfaces COM delegando las llamadas a QueryInterface(), AddRef() y Release() a la interfaz proporcionada por controllingUnknown().
Utiliza el método widget() si necesitas realizar llamadas a QWidget que implementa el control ActiveX. No debes almacenar ese puntero en tu subclase (a menos que utilices QPointer), ya que el QWidget puede ser destruido por el marco ActiveQt en cualquier momento.
Véase también QAxBindable, QAxFactory y Active Qt.
Documentación de las funciones miembro
[constexpr noexcept protected default] QAxAggregated::QAxAggregated()
Crea por defecto una instancia de ` QAxAggregated`.
[virtual constexpr noexcept protected default] QAxAggregated::~QAxAggregated()
Qt llama al destructor de forma interna.
[protected] IUnknown *QAxAggregated::controllingUnknown() const
Devuelve la interfaz ` IUnknown ` del control ActiveX. Implementa la interfaz ` IUnknown ` en tu subclase de ` QAxAggregated ` para delegar las llamadas a ` QueryInterface()`, ` AddRef()` y ` Release() ` a la interfaz proporcionada por esta función.
HRESULT AxImpl::QueryInterface(REFIID iid, void **iface)
{
return controllingUnknown()->QueryInterface(iid, iface);
}
ulong AxImpl::AddRef()
{
return controllingUnknown()->AddRef();
}
ulong AxImpl::Release()
{
return controllingUnknown()->Release();
}En lugar de declarar e implementar estas tres funciones manualmente, puede utilizar la macro QAXAGG_IUNKNOWN en la declaración de clase de su subclase.
[protected] QObject *QAxAggregated::object() const
Devuelve un puntero a la subclase de ` QObject ` que implementa el objeto COM. Esta función puede devolver 0.
Advertencia: Nodebes almacenar el puntero devuelto, a menos que utilices un ` QPointer`, ya que ActiveQt puede destruir el ` QObject ` en cualquier momento.
[pure virtual] long QAxAggregated::queryInterface(const QUuid &iid, void **iface)
Reimplementa esta función virtual pura para admitir interfaces COM adicionales. Establece el valor de ` iface ` para que apunte a este objeto y así admitir la interfaz ` iid`. Ten en cuenta que debes convertir el puntero ` this ` a la superclase adecuada.
long AxImpl::queryInterface(const QUuid &iid, void **iface)
{
*iface = 0;
if (iid == IID_ISomeCOMInterface)
*iface = (ISomeCOMInterface*)this;
else
return E_NOINTERFACE;
AddRef();
return S_OK;
}Devuelve los resultados estándar de COM: ` S_OK ` (la interfaz es compatible) o ` E_NOINTERFACE ` (la interfaz solicitada no es compatible).
Advertencia: Aunque es obligatorio implementar la interfaz IUnknown si se implementa cualquier interfaz COM, no se debe admitir la interfaz IUnknown en la implementación de queryInterface().
[protected] QWidget *QAxAggregated::widget() const
Devuelve un puntero a la subclase de QWidget que implementa el control ActiveX. Esta función puede devolver 0.
© 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.