QAxWidget Class

Documentation des fonctions membres

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

Crée un widget QAxWidget vide et propage parent et f au constructeur QWidget. Pour initialiser un contrôle, appelez setControl().

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

Crée un QAxWidget qui enveloppe l'objet COM référencé par iface. parent et f sont propagés dans le contructeur QWidget.

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

Crée un widget QAxWidget et initialise le contrôle ActiveX c. parent et f sont propagés dans le constructeur QWidget.

Voir aussi setControl().

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

Ferme le contrôle ActiveX et détruit le widget QAxWidget, en nettoyant toutes les ressources allouées.

Voir également clear().

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

Réimplémente : QWidget::changeEvent(QEvent *event).

void QAxWidget::clear()

Ferme le contrôle ActiveX.

Voir aussi resetControl().

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

Réimplémente : QObject::connectNotify(const QMetaMethod &signal).

[virtual] QAxAggregated *QAxWidget::createAggregate()

Réimplémentez cette fonction lorsque vous souhaitez implémenter des interfaces COM supplémentaires pour le site client du contrôle ActiveX, ou lorsque vous souhaitez fournir des implémentations alternatives d'interfaces COM. Renvoie un nouvel objet d'une sous-classe de QAxAggregated.

L'implémentation par défaut renvoie le pointeur null.

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

Crée le site client pour le contrôle ActiveX et renvoie vrai si le contrôle a pu être intégré avec succès, sinon renvoie faux. Si initialized est vrai, le contrôle a déjà été initialisé.

Cette fonction est appelée par initialize(). Si vous réimplémentez initialize pour personnaliser l'instanciation du contrôle, appelez cette fonction dans votre réimplémentation pour que le contrôle soit intégré par défaut côté client. Crée le site client pour le contrôle ActiveX et renvoie un message vrai si le contrôle a pu être intégré avec succès, sinon il renvoie un message faux.

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

Crée le site client pour le contrôle ActiveX et retourne vrai si le contrôle a pu être incorporé avec succès, sinon il retourne faux. Si initialized est faux, le contrôle sera initialisé à l'aide de l'interface data. Le contrôle sera initialisé à l'aide de l'interface IPersistStreamInit ou IPersistStorage.

Si le contrôle doit être initialisé à l'aide de données personnalisées, appelez cette fonction dans votre réimplémentation de initialize(). Cette fonction n'est pas appelée par l'implémentation par défaut de initialize().

bool QAxWidget::doVerb(const QString &verb)

Demande au contrôle ActiveX d'effectuer l'action verb. Les verbes possibles sont renvoyés par verbs().

La fonction renvoie un résultat vrai si l'objet peut effectuer l'action, sinon elle renvoie un résultat faux.

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

Réimplémente : QAxBase::initialize(IUnknown **ptr).

Appelle QAxBase::initialize(ptr), et intègre le contrôle dans ce widget en appelant createHostWindow(false) en cas de succès.

Pour initialiser le contrôle avant qu'il ne soit activé, réimplémentez cette fonction et ajoutez votre code d'initialisation avant d'appeler createHostWindow(true).

Retourne true en cas de succès, false dans le cas contraire.

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

Réimplémente une fonction d'accès à la propriété : QWidget::minimumSizeHint.

[override virtual] void QAxWidget::resetControl()

Réimplémente : QAxObjectInterface::resetControl().

Ferme le contrôle ActiveX.

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

Réimplémente : QWidget::resizeEvent(QResizeEvent *event).

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

Réimplémente une fonction d'accès à la propriété : QWidget::sizeHint.

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

Réimplémentez cette fonction pour transmettre certains événements de touches au contrôle ActiveX. message est l'identifiant du message Window spécifiant le type de message (c'est-à-dire WM_KEYDOWN), et keycode est le code de la touche virtuelle (c'est-à-dire VK_TAB).

Si la fonction renvoie un message vrai, l'événement touche est transmis au contrôle ActiveX, qui traite l'événement ou le transmet à Qt.

Si la fonction renvoie false, le traitement de l'événement clé est ignoré par ActiveQt, c'est-à-dire que le contrôle ActiveX peut le gérer ou non.

L'implémentation par défaut renvoie true dans les cas suivants :

Ce tableau est le résultat d'une expérience avec les contrôles ActiveX les plus courants, c'est-à-dire Internet Explorer et les applications Microsoft Office, mais il peut nécessiter des modifications pour certains contrôles.