Sur cette page

QTestEventList Class

La classe QTestEventList fournit une liste d'événements de l'interface graphique. En savoir plus...

En-tête : #include <QTestEventList>
CMake : find_package(Qt6 REQUIRED COMPONENTS Test)
target_link_libraries(mytarget PRIVATE Qt6::Test)
qmake : QT += testlib
Hérite de : QList

Fonctions publiques

QTestEventList()
QTestEventList(const QTestEventList &other)
~QTestEventList()
void addDelay(int msecs)
void addKeyClick(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyClick(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyClicks(const QString &keys, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyPress(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyPress(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyRelease(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyRelease(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addMouseClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void addMouseDClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void addMouseMove(QPoint pos = QPoint(), int delay = -1)
void addMousePress(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void addMouseRelease(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void clear()
void simulate(QWidget *w)

Description détaillée

Une QTestEventList peut être remplie d'événements d'interface graphique qui peuvent être stockés en tant que données de test pour une utilisation ultérieure, ou être rejoués sur n'importe quelle QWidget. QTestEventList fournit des fonctions pratiques pour remplir la liste.

Exemple :

QTestEventList events;
events.addKeyClick('a');
events.addKeyClick(Qt::Key_Backspace);
events.addDelay(200);
QLineEdit *lineEdit = new QLineEdit(myParent);
// ...
events.simulate(lineEdit);
events.simulate(lineEdit);

L'exemple ci-dessus simule la saisie par l'utilisateur du caractère a, suivie d'une touche « retour arrière », d'un temps d'attente de 200 millisecondes, puis de la répétition de cette opération.

Documentation des fonctions membres

QTestEventList::QTestEventList()

Crée un objet `QTestEventList` vide.

QTestEventList::QTestEventList(const QTestEventList &other)

Crée un nouvel objet `QTestEventList` en tant que copie de ` other`.

[noexcept] QTestEventList::~QTestEventList()

Vide la liste et supprime tous les événements enregistrés.

void QTestEventList::addDelay(int msecs)

Ajoute un délai de msecs millisecondes.

Voir aussi QTest::qWait().

void QTestEventList::addKeyClick(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute une nouvelle pression de touche à la liste. L'événement simulera la pression de la touche qtKey avec le modificateur modifiers, puis attendra msecs millisecondes.

Voir également QTest::keyClick().

void QTestEventList::addKeyClick(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute une nouvelle pression de touche à la liste. L'événement simulera la pression de la touche ascii avec le modificateur modifiers, puis attendra msecs millisecondes.

Il s'agit d'une fonction surchargée.

Voir également QTest::keyClick().

void QTestEventList::addKeyClicks(const QString &keys, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute de nouvelles entrées de clavier à la liste. L'événement appuie sur les touches keys avec l'modifiers, en attendant msecs millisecondes entre chaque touche.

Voir également QTest::keyClicks().

void QTestEventList::addKeyPress(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute une nouvelle pression de touche à la liste. L'événement appuiera sur la touche qtKey avec le modificateur modifiers, puis attendra msecs millisecondes.

Voir également QTest::keyPress().

void QTestEventList::addKeyPress(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute une nouvelle pression de touche à la liste. L'événement simulera la pression de la touche ascii avec le modificateur modifiers, puis attendra msecs millisecondes.

Il s'agit d'une fonction surchargée.

Voir également QTest::keyPress().

void QTestEventList::addKeyRelease(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute une nouvelle libération de touche à la liste. L'événement libère la touche qtKey avec le modificateur modifiers, puis attend msecs millisecondes.

Voir également QTest::keyRelease().

void QTestEventList::addKeyRelease(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Ajoute un nouvel événement de relâchement de touche à la liste. L'événement relâche la touche ascii avec le modificateur modifiers, puis attend msecs millisecondes.

Il s'agit d'une fonction surchargée.

Voir également QTest::keyRelease().

void QTestEventList::addMouseClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Ajoutez un clic de souris à la liste. L'événement déclenchera un clic sur l'élément button, avec un modifiers facultatif, à la position pos, avec un delay facultatif. La position par défaut est le centre du widget.

Voir également QTest::mouseClick().

void QTestEventList::addMouseDClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Ajoute un double-clic à la liste. L'événement effectuera un double-clic sur l'élément button avec, en option, l'modifiers, à la position pos avec, en option, l'delay. La position par défaut est le centre du widget.

Voir également QTest::mousePress().

void QTestEventList::addMouseMove(QPoint pos = QPoint(), int delay = -1)

Ajoute un déplacement de souris à la liste. L'événement déplacera la souris à la position pos. Si un délai ( delay, en millisecondes) est défini, le test attendra après avoir déplacé la souris. La position par défaut est le centre du widget.

Voir également QTest::mousePress().

void QTestEventList::addMousePress(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Ajoute un clic de souris à la liste. L'événement déclenchera un clic sur l'élément ` button `, avec un ` modifiers ` facultatif, à la position ` pos `, avec un ` delay` facultatif. La position par défaut est le centre du widget.

Voir également QTest::mousePress().

void QTestEventList::addMouseRelease(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Ajoutez un événement « relâchement de souris » à la liste. Cet événement relâchera l'button, avec un modifiers facultatif, à la position pos, avec un delay facultatif. La position par défaut est le centre du widget.

Voir également QTest::mouseRelease().

void QTestEventList::clear()

Supprime tous les événements de la liste.

void QTestEventList::simulate(QWidget *w)

Simule les événements de la liste un par un sur le widget w. Pour un exemple, veuillez consulter la documentation de la classe QTestEventList.

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