QAxWidget Class

Documentación de funciones miembro

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

Crea un widget QAxWidget vacío y propaga 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 referenciado por iface. parent y f se propagan al constructor 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. parent y f se propagan al constructor QWidget.

Véase también setControl().

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

Cierra el control ActiveX y destruye el widget QAxWidget, limpiando 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()

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

La implementación por defecto devuelve el puntero nulo.

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

Crea el sitio cliente para el control ActiveX, y devuelve true si el control pudo ser incrustado con éxito, en caso contrario devuelve false. Si initialized es true el control ya ha sido inicializado.

Esta función es llamada por initialize(). Si reimplementa initialize para personalizar la instanciación real del control, llame a esta función en su reimplementación para que el control sea incrustado por el lado del cliente por defecto. Crea el sitio cliente para el control ActiveX, y devuelve true si el control pudo ser incrustado con éxito, en caso contrario devuelve false.

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

Crea el sitio cliente para el control ActiveX, y devuelve true si el control ha podido ser incrustado con éxito, en caso contrario devuelve false. Si initialized es false, el control se inicializará utilizando la interfaz data. El control se inicializará a través de la interfaz IPersistStreamInit o IPersistStorage.

Si el control necesita ser inicializado utilizando datos personalizados, llame a esta función en su reimplementación de initialize(). Esta función no es llamada por la implementación por defecto de initialize().

bool QAxWidget::doVerb(const QString &verb)

Solicita al control ActiveX que realice la acción verb. Los posibles verbos son devueltos por verbs().

La función devuelve true si el objeto puede 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 incrusta el control en este widget llamando a createHostWindow(false) si tiene éxito.

Para inicializar el control antes de activarlo, reimplemente esta función y añada su código de inicialización antes de llamar a createHostWindow(true).

Devuelve true en caso de éxito, 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

Reimplemente esta función para pasar ciertos eventos de tecla al control ActiveX. message es el identificador de mensaje de Window que especifica el tipo de mensaje (por ejemplo, WM_KEYDOWN), y keycode es el código de tecla virtual (por ejemplo, VK_TAB).

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

Si la función devuelve false el procesamiento del evento clave es ignorado por ActiveQt, es decir, el control ActiveX puede manejarlo o no.

La implementación por defecto devuelve true para los siguientes casos:

Esta tabla es el resultado de experimentar con controles ActiveX populares, es decir, Internet Explorer y aplicaciones de Microsoft Office, pero para algunos controles puede requerir modificaciones.