QTest::QTouchEventSequence Class
class QTest::QTouchEventSequenceLa classe QTouchEventSequence est utilisée pour simuler une séquence d'événements tactiles. Plus d'informations...
| En-tête : | #include <QTouchEventSequence> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Test)target_link_libraries(mytarget PRIVATE Qt6::Test) |
| qmake : | QT += testlib |
| Inherited By : |
Fonctions publiques
| virtual | ~QTouchEventSequence() |
| virtual bool | commit(bool processEvents = true) |
| QTest::QTouchEventSequence & | move(int touchId, const QPoint &pt, QWindow *window = nullptr) |
| QTest::QTouchEventSequence & | press(int touchId, const QPoint &pt, QWindow *window = nullptr) |
| QTest::QTouchEventSequence & | release(int touchId, const QPoint &pt, QWindow *window = nullptr) |
| virtual QTest::QTouchEventSequence & | stationary(int touchId) |
Description détaillée
Pour simuler une séquence d'événements tactiles sur un dispositif spécifique pour une fenêtre ou un widget, appelez QTest::touchEvent pour créer une instance QTouchEventSequence. Ajoutez des événements tactiles à la séquence en appelant press(), move(), release() et stationary(), et laissez l'instance s'exécuter hors du champ d'application pour valider la séquence dans le système d'événements.
Exemple :
QTouchDevice *dev = QTest::createTouchDevice(); QWidget widget; QTest::touchEvent(&widget, dev) .press(0, QPoint(10, 10)); QTest::touchEvent(&widget, dev) .stationary(0) .press(1, QPoint(40, 10)); QTest::touchEvent(&widget, dev) .move(0, QPoint(12, 12)) .move(1, QPoint(45, 5)); QTest::touchEvent(&widget, dev) .release(0, QPoint(12, 12)) .release(1, QPoint(45, 5));
Documentation d'une fonction membre
[virtual noexcept] QTouchEventSequence::~QTouchEventSequence()
Valide cette séquence d'événements tactiles, à moins que la validation automatique n'ait été désactivée, et libère les ressources allouées.
[virtual] bool QTouchEventSequence::commit(bool processEvents = true)
Enregistre cet événement tactile dans le système d'événements et indique s'il a été accepté après livraison.
Normalement, il n'est pas nécessaire d'appeler cette fonction car elle est appelée par le destructeur. Toutefois, si la fonction autoCommit est désactivée, les événements ne sont pris en compte qu'en cas d'appel explicite de cette fonction. Une autre raison de l'appeler explicitement est de vérifier la valeur de retour.
Dans des cas particuliers, les tests peuvent vouloir désactiver le traitement de l'événement. Pour ce faire, il suffit d'attribuer la valeur false à processEvents. Il en résulte une simple mise en file d'attente de l'événement : la boucle d'événements n'est pas obligée de le traiter.
Retourne si l'événement a été accepté après livraison.
QTest::QTouchEventSequence &QTouchEventSequence::move(int touchId, const QPoint &pt, QWindow *window = nullptr)
Ajoute un événement de déplacement pour le point de contact touchId à la position pt à cette séquence et renvoie une référence à ce QTouchEventSequence.
La position pt est interprétée comme étant relative à window. Si window est le pointeur nul, alors pt est interprété comme étant relatif à la fenêtre fournie lors de l'instanciation de ce QTouchEventSequence.
Simule que l'utilisateur a déplacé le doigt identifié par touchId.
QTest::QTouchEventSequence &QTouchEventSequence::press(int touchId, const QPoint &pt, QWindow *window = nullptr)
Ajoute un événement de pression pour le point de contact touchId à la position pt à cette séquence et renvoie une référence à QTouchEventSequence.
La position pt est interprétée comme étant relative à window. Si window est le pointeur nul, alors pt est interprété comme étant relatif à la fenêtre fournie lors de l'instanciation de ce QTouchEventSequence.
Simule que l'utilisateur a appuyé sur l'écran tactile ou le pavé tactile avec le doigt identifié par touchId.
QTest::QTouchEventSequence &QTouchEventSequence::release(int touchId, const QPoint &pt, QWindow *window = nullptr)
Ajoute un événement de libération pour le point de contact touchId à la position pt à cette séquence et renvoie une référence à ce QTouchEventSequence.
La position pt est interprétée comme étant relative à window. Si window est le pointeur nul, alors pt est interprété comme étant relatif à la fenêtre fournie lors de l'instanciation de ce QTouchEventSequence.
Simule que l'utilisateur a levé le doigt identifié par touchId.
[virtual] QTest::QTouchEventSequence &QTouchEventSequence::stationary(int touchId)
Ajoute un événement stationnaire pour le point de contact touchId à cette séquence et renvoie une référence à ce QTouchEventSequence.
Simule que l'utilisateur n'a pas bougé le doigt identifié par touchId.
© 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.
