QTest::QTouchEventSequence Class
class QTest::QTouchEventSequenceLa clase QTouchEventSequence se utiliza para simular una secuencia de eventos táctiles. Más...
| Cabecera: | #include <QTouchEventSequence> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Test)target_link_libraries(mytarget PRIVATE Qt6::Test) |
| qmake: | QT += testlib |
| Heredado Por: |
Funciones Públicas
| 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) |
Descripción detallada
Para simular una secuencia de eventos táctiles en un dispositivo específico para una ventana o widget, llama a QTest::touchEvent para crear una instancia QTouchEventSequence. Añade eventos táctiles a la secuencia llamando a press(), move(), release() y stationary(), y deja que la instancia se ejecute fuera del ámbito para registrar la secuencia en el sistema de eventos.
Ejemplo:
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));
Documentación de funciones miembro
[virtual noexcept] QTouchEventSequence::~QTouchEventSequence()
Compromete esta secuencia de eventos táctiles, a menos que se haya desactivado autoCommit, y libera los recursos asignados.
[virtual] bool QTouchEventSequence::commit(bool processEvents = true)
Consigna este evento de toque al sistema de eventos, y devuelve si fue aceptado después de la entrega.
Normalmente no hay necesidad de llamar a esta función porque es llamada desde el destructor. Sin embargo, si autoCommit está deshabilitado, los eventos sólo se comprometen cuando se llama explícitamente a esta función. Otra razón para llamarla explícitamente es para comprobar el valor de retorno.
En casos especiales, las pruebas pueden querer deshabilitar el procesamiento del evento. Esto se puede conseguir estableciendo processEvents a false. El resultado será simplemente poner el evento en cola: el bucle de eventos no se verá forzado a procesarlo.
Devuelve si el evento fue aceptado después de la entrega.
QTest::QTouchEventSequence &QTouchEventSequence::move(int touchId, const QPoint &pt, QWindow *window = nullptr)
Añade un evento de movimiento para el punto de contacto touchId en la posición pt a esta secuencia y devuelve una referencia a este QTouchEventSequence.
La posición pt se interpreta como relativa a window. Si window es el puntero nulo, entonces pt se interpreta como relativa a la ventana proporcionada al instanciar este QTouchEventSequence.
Simula que el usuario ha movido el dedo identificado por touchId.
QTest::QTouchEventSequence &QTouchEventSequence::press(int touchId, const QPoint &pt, QWindow *window = nullptr)
Añade un evento de pulsación para el punto de contacto touchId en la posición pt a esta secuencia y devuelve una referencia a este QTouchEventSequence.
La posición pt se interpreta como relativa a window. Si window es el puntero nulo, entonces pt se interpreta como relativa a la ventana proporcionada al instanciar este QTouchEventSequence.
Simula que el usuario ha pulsado la pantalla táctil con el dedo identificado por touchId.
QTest::QTouchEventSequence &QTouchEventSequence::release(int touchId, const QPoint &pt, QWindow *window = nullptr)
Añade un evento de liberación para el punto de contacto touchId en la posición pt a esta secuencia y devuelve una referencia a este QTouchEventSequence.
La posición pt se interpreta como relativa a window. Si window es el puntero nulo, entonces pt se interpreta como relativa a la ventana proporcionada al instanciar este QTouchEventSequence.
Simula que el usuario ha levantado el dedo identificado por touchId.
[virtual] QTest::QTouchEventSequence &QTouchEventSequence::stationary(int touchId)
Añade un evento estacionario para el punto táctil touchId a esta secuencia y devuelve una referencia a este QTouchEventSequence.
Simula que el usuario no ha movido el dedo identificado por 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.
