En esta página

QTest::QTouchEventSequence Class

class QTest::QTouchEventSequence

La clase QTouchEventSequence se utiliza para simular una secuencia de eventos táctiles. Más información...

Encabezado: #include <qtestsupport_gui.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Test)
target_link_libraries(mytarget PRIVATE Qt6::Test)
qmake: QT += testlib
Heredado por:

QTest::QTouchEventWidgetSequence

Funciones públicas

virtual ~QTouchEventSequence()
(since 6.12) bool cancel(bool processEvents = true)
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 un widget, llama a QTest::touchEvent para crear una instancia de QTouchEventSequence. Añade eventos táctiles a la secuencia llamando a press(), move(), release() y stationary(), y deja que la instancia salga del ámbito para que la secuencia se aplique al 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 las funciones de miembro

[virtual noexcept] QTouchEventSequence::~QTouchEventSequence()

Confirma esta secuencia de eventos táctiles, a menos que se haya desactivado la opción «autoCommit», y libera los recursos asignados.

[since 6.12] bool QTouchEventSequence::cancel(bool processEvents = true)

Aplica una cancelación de toque al dispositivo de la secuencia y devuelve si se ha aceptado. Si ` processEvents ` es ` true ` (valor por defecto), a continuación se ejecuta el bucle de eventos.

Simula que la secuencia táctil se ha cancelado, por ejemplo, por parte del compositor. Se descartan todos los puntos preparados pero aún no confirmados y, dado que una cancelación solo puede ir seguida de una nueva pulsación, los puntos memorizados también se olvidan.

Esta función se introdujo en Qt 6.12.

[virtual] bool QTouchEventSequence::commit(bool processEvents = true)

Envía este evento táctil al sistema de eventos y devuelve si ha sido aceptado tras su envío.

Normalmente no es necesario llamar a esta función, ya que se invoca desde el destructor. Sin embargo, si autoCommit está desactivado, los eventos solo se registran al llamar explícitamente a esta función. Otra razón para llamarla explícitamente es comprobar el valor de retorno.

En casos especiales, es posible que en las pruebas se desee desactivar el procesamiento del evento. Esto se puede lograr estableciendo ` processEvents ` en `false`. De este modo, el evento simplemente se pone en cola: el bucle de eventos no se verá obligado a procesarlo.

Devuelve si el evento fue aceptado tras su entrega.

QTest::QTouchEventSequence &QTouchEventSequence::move(int touchId, const QPoint &pt, QWindow *window = nullptr)

Añade un evento de movimiento para el punto táctil 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 un 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 táctil 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 un 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 o el panel 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 táctil 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 un puntero nulo, entonces pt se interpreta como relativa a la ventana proporcionada al instanciar este QTouchEventSequence.

Simula que el usuario ha retirado el dedo identificado por touchId.

[virtual] QTest::QTouchEventSequence &QTouchEventSequence::stationary(int touchId)

Añade un evento estacionario para el punto de contacto 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.