Qt Documentation

Contents

QTouchEventSequence Class

(QTest::QTouchEventSequence)

The QTouchEventSequence class is used to simulate a sequence of touch events. More...

Header: #include <QTouchEventSequence>
Since: Qt 4.6

Public Functions

~QTouchEventSequence()
QTouchEventSequence & move(int touchId, const QPoint & pt, QWidget * widget = 0)
QTouchEventSequence & press(int touchId, const QPoint & pt, QWidget * widget = 0)
QTouchEventSequence & release(int touchId, const QPoint & pt, QWidget * widget = 0)
QTouchEventSequence & stationary(int touchId)

Detailed Description

The QTouchEventSequence class is used to simulate a sequence of touch events.

To simulate a sequence of touch events on a specific device for a widget, call QTest::touchEvent to create a QTouchEventSequence instance. Add touch events to the sequence by calling press(), move(), release() and stationary(), and let the instance run out of scope to commit the sequence to the event system.

Example:

QWidget widget;

QTest::touchEvent(&widget)
    .press(0, QPoint(10, 10));
QTest::touchEvent(&widget)
    .stationary(0)
    .press(1, QPoint(40, 10));
QTest::touchEvent(&widget)
    .move(0, QPoint(12, 12))
    .move(1, QPoint(45, 5));
QTest::touchEvent(&widget)
    .release(0)
    .release(1);

Member Function Documentation

QTouchEventSequence::~QTouchEventSequence()

Commits this sequence of touch events and frees allocated resources.

QTouchEventSequence & QTouchEventSequence::move(int touchId, const QPoint & pt, QWidget * widget = 0)

Adds a move event for touchpoint touchId at position pt to this sequence and returns a reference to this QTouchEventSequence.

The position pt is interpreted as relative to widget. If widget is the null pointer, then pt is interpreted as relative to the widget provided when instantiating this QTouchEventSequence.

Simulates that the user moved the finger identified by touchId.

QTouchEventSequence & QTouchEventSequence::press(int touchId, const QPoint & pt, QWidget * widget = 0)

Adds a press event for touchpoint touchId at position pt to this sequence and returns a reference to this QTouchEventSequence.

The position pt is interpreted as relative to widget. If widget is the null pointer, then pt is interpreted as relative to the widget provided when instantiating this QTouchEventSequence.

Simulates that the user pressed the touch screen or pad with the finger identified by touchId.

QTouchEventSequence & QTouchEventSequence::release(int touchId, const QPoint & pt, QWidget * widget = 0)

Adds a release event for touchpoint touchId at position pt to this sequence and returns a reference to this QTouchEventSequence.

The position pt is interpreted as relative to widget. If widget is the null pointer, then pt is interpreted as relative to the widget provided when instantiating this QTouchEventSequence.

Simulates that the user lifted the finger identified by touchId.

QTouchEventSequence & QTouchEventSequence::stationary(int touchId)

Adds a stationary event for touchpoint touchId to this sequence and returns a reference to this QTouchEventSequence.

Simulates that the user did not move the finger identified by touchId.

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