En esta página

QAxWidget Class

La clase QAxWidget es un « QWidget » que envuelve un control ActiveX. Más información...

Encabezado: #include <qaxwidget.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS AxContainer)
target_link_libraries(mytarget PRIVATE Qt6::AxContainer)
qmake: QT += axcontainer
Heredado de:QAxBaseWidget y QAxBase

Funciones públicas

QAxWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
QAxWidget(IUnknown *iface, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
QAxWidget(const QString &c, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
virtual ~QAxWidget() override
void clear()
virtual QAxAggregated *createAggregate()
bool doVerb(const QString &verb)

Funciones públicas reimplementadas

virtual QSize minimumSizeHint() const override
virtual void resetControl() override
virtual QSize sizeHint() const override

Funciones protegidas

virtual bool createHostWindow(bool initialized)
bool createHostWindow(bool initialized, const QByteArray &data)
virtual bool translateKeyEvent(int message, int keycode) const

Funciones protegidas reimplementadas

virtual void changeEvent(QEvent *e) override
virtual void connectNotify(const QMetaMethod &signal) override
virtual bool initialize(IUnknown **ptr) override
virtual void resizeEvent(QResizeEvent *) override

Descripción detallada

Un QAxWidget puede instanciarse como un objeto vacío, con el nombre del control ActiveX que debe envolver, o con un puntero de interfaz ya existente al control ActiveX. Las propiedades, métodos y eventos del control ActiveX que solo utilizan tipos de datos compatibles c QAxBase, pasan a estar disponibles como propiedades, ranuras y señales de Qt. La clase base QAxBase proporciona una API para acceder directamente al ActiveX a través del puntero IUnknown.

QAxWidget es un « QWidget » y, en su mayor parte, puede utilizarse como tal; por ejemplo, puede organizarse en una jerarquía de widgets y diseños o actuar como filtro de eventos. Se admiten las propiedades estándar de los widgets, como enabled, pero la implementación de propiedades ambientales —como, por ejemplo, la paleta de colores o la fuente— depende del control ActiveX. QAxWidget intenta proporcionar las indicaciones necesarias.

Sin embargo, no se pueden reimplementar controladores de eventos específicos de Qt, como `mousePressEvent` o `keyPressEvent`, y esperar que se invoquen de forma fiable. El control integrado cubre completamente el QAxWidget y, por lo general, se encarga él mismo de la interfaz de usuario. Utiliza las API específicas del control (es decir, escucha las señales del control) o emplea técnicas COM estándar, como la subclasificación de procedimientos de ventana.

QAxWidget también hereda la mayor parte de su funcionalidad relacionada con ActiveX de QAxBase, en particular dynamicCall() y querySubObject().

Advertencia: Se puede crear una subclase de QAxWidget, pero no se puede utilizar la macro Q_OBJECT en la subclase (el archivo moc generado no se compilará), por lo que no se pueden añadir más señales, ranuras ni propiedades. Esta limitación se debe a la información de metaobjetos generada en tiempo de ejecución. Para solucionar este problema, agrega el QAxWidget como miembro de la subclase QObject.

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

Documentación de las funciones de miembro

[explicit] QAxWidget::QAxWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Crea un widget QAxWidget vacío y pasa los parámetros ` parent ` y ` f ` al constructor ` QWidget `. Para inicializar un control, llama a ` setControl()`.

[explicit] QAxWidget::QAxWidget(IUnknown *iface, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Crea un QAxWidget que envuelve el objeto COM al que hace referencia iface. Los parámetros parent y f se transmiten al constructor de QWidget.

[explicit] QAxWidget::QAxWidget(const QString &c, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Crea un widget QAxWidget e inicializa el control ActiveX c. Los parámetros parent y f se transmiten al constructor de QWidget.

Véase también setControl().

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

Cierra el control ActiveX y elimina el widget « QAxWidget », liberando todos los recursos asignados.

Véase también clear().

[override virtual protected] void QAxWidget::changeEvent(QEvent *e)

Reimplementa: ` QWidget::changeEvent(QEvent *event)`.

void QAxWidget::clear()

Cierra el control ActiveX.

Véase también resetControl().

[override virtual protected] void QAxWidget::connectNotify(const QMetaMethod &signal)

Reimplementa: QObject::connectNotify(const QMetaMethod &signal).

[virtual] QAxAggregated *QAxWidget::createAggregate()

Reimplementa esta función cuando desees implementar interfaces COM adicionales para el lado cliente del control ActiveX, o cuando desees proporcionar implementaciones alternativas de interfaces COM. Devuelve un nuevo objeto de una subclase de ` QAxAggregated `.

La implementación predeterminada devuelve el puntero nulo.

[virtual protected] bool QAxWidget::createHostWindow(bool initialized)

Crea el sitio de cliente para el control ActiveX y devuelve «true» si el control se ha podido incrustar correctamente; en caso contrario, devuelve «false». Si initialized es «true», el control ya se ha inicializado.

Esta función es llamada por initialize(). Si reimplementas initialize para personalizar la instanciación del control, llama a esta función en tu reimplementación para que el control se incruste en el lado del cliente por defecto. Crea el lado del cliente para el control ActiveX y devuelve «true» si el control se ha podido incrustar correctamente; en caso contrario, devuelve «false».

[protected] bool QAxWidget::createHostWindow(bool initialized, const QByteArray &data)

Crea el sitio de cliente para el control ActiveX y devuelve «true» si el control se ha podido incrustar correctamente; en caso contrario, devuelve «false». Si ` initialized ` es «false», el control se inicializará mediante ` data`. El control se inicializará a través de la interfaz `IPersistStreamInit` o `IPersistStorage`.

Si es necesario inicializar el control utilizando datos personalizados, llama a esta función en tu reimplementación de initialize(). La implementación predeterminada de initialize() no llama a esta función.

bool QAxWidget::doVerb(const QString &verb)

Solicita al control ActiveX que realice la acción « verb ». Los verbos posibles se obtienen mediante la función « verbs()».

La función devuelve «true» si el objeto pudo realizar la acción; en caso contrario, devuelve «false».

[override virtual protected] bool QAxWidget::initialize(IUnknown **ptr)

Reimplementa: QAxBase::initialize(IUnknown **ptr).

Llama a QAxBase::initialize(ptr) e integra el control en este widget llamando a createHostWindow(false) si la operación se realiza correctamente.

Para inicializar el control antes de que se active, reimplementa esta función y añade tu código de inicialización antes de llamar a createHostWindow(true).

Devuelve true si se realiza correctamente; false en caso contrario.

[override virtual] QSize QAxWidget::minimumSizeHint() const

Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.

[override virtual] void QAxWidget::resetControl()

Reimplementa: QAxObjectInterface::resetControl().

Cierra el control ActiveX.

[override virtual protected] void QAxWidget::resizeEvent(QResizeEvent *)

Reimplementa: QWidget::resizeEvent(QResizeEvent *event).

[override virtual] QSize QAxWidget::sizeHint() const

Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.

[virtual protected] bool QAxWidget::translateKeyEvent(int message, int keycode) const

Reimplementa esta función para pasar determinados eventos de teclas al control ActiveX. « message » es el identificador del mensaje de ventana que especifica el tipo de mensaje (p. ej., WM_KEYDOWN), y « keycode » es el código de tecla virtual (p. ej., VK_TAB).

Si la función devuelve «true», el evento de tecla se transmite al control ActiveX, que a continuación procesa el evento o lo transmite a Qt.

Si la función devuelve «false», ActiveQt ignora el procesamiento del evento de tecla; es decir, el control ActiveX puede gestionarlo o no.

La implementación por defecto devuelve «true» en los siguientes casos:

WM_SYSKEYDOWNWM_SYSKEYUPWM_KEYDOWN
Todos los códigos de teclaVK_MENUVK_TAB, VK_DELETE y todas las teclas que no sean de flecha en combinación con VK_SHIFT, VK_CONTROL o VK_MENU

Esta tabla es el resultado de realizar pruebas con controles ActiveX habituales, como Internet Explorer y las aplicaciones de Microsoft Office, pero es posible que haya que modificarla para algunos controles.

© 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.