QAxWidget Class

Documentation des fonctions membres

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

Crée un widget QAxWidget vide et transmet les paramètres ` parent ` et ` f ` au constructeur ` QWidget `. Pour initialiser un contrôle, appelez la méthode ` setControl()`.

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

Crée un QAxWidget qui encapsule l'objet COM référencé par iface. Les paramètres parent et f sont transmis au constructeur 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. Les paramètres parent et f sont transmis au constructeur QWidget.

Voir également setControl().

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

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

Voir aussi 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 côté client du contrôle ActiveX, ou lorsque vous souhaitez fournir d'autres implémentations d'interfaces COM. Renvoyez 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 « true » si le contrôle a pu être intégré avec succès ; dans le cas contraire, renvoie « false ». Si la valeur de ` initialized ` est « true », cela signifie que le contrôle a déjà été initialisé.

Cette fonction est appelée par initialize(). Si vous réimplémentez la méthode initialize pour personnaliser l'instanciation du contrôle, appelez cette fonction dans votre réimplémentation afin que le contrôle soit intégré par le côté client par défaut. Crée le côté client du contrôle ActiveX et renvoie « true » si le contrôle a pu être intégré avec succès, sinon renvoie « false ».

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

Crée le site client pour le contrôle ActiveX et renvoie « true » si le contrôle a pu être intégré avec succès ; dans le cas contraire, renvoie « false ». Si la valeur de ` initialized ` est « false », le contrôle sera initialisé à l’aide de ` data`. Le contrôle sera initialisé via 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 la fonction verbs().

La fonction renvoie « true » si l'objet a pu effectuer l'action, sinon elle renvoie « false ».

[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 réussite.

Pour initialiser le contrôle avant son activation, réimplémentez cette fonction et ajoutez votre code d'initialisation avant d'appeler createHostWindow(true).

Renvoie true en cas de réussite, false dans le cas contraire.

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

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

[override virtual] void QAxWidget::resetControl()

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

Arrête 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 pour 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 touche au contrôle ActiveX. ` message ` est l'identifiant du message Windows spécifiant le type de message (par exemple, `WM_KEYDOWN`), et ` keycode ` est le code de touche virtuel (par exemple, `VK_TAB`).

Si la fonction renvoie « true », l'événement de touche est transmis au contrôle ActiveX, qui le traite alors ou le transmet à Qt.

Si la fonction renvoie « false », le traitement de l'événement de touche est ignoré par ActiveQt ; en d'autres termes, 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'expérimentations menées avec des contrôles ActiveX courants, tels qu'Internet Explorer et les applications Microsoft Office, mais il peut nécessiter des modifications pour certains contrôles.