TouchEventSequence QML Type | Qt Quick 5.9

Qt 5.9 | Qt Quick | QML Types | TouchEventSequence QML Type

Qt 5.9.3 Reference Documentation

# TouchEventSequence QML Type

TouchEventSequence is used to build and dispatch touch events for testing. More...

Import Statement: | import QtTest 1.1
Since: | Qt 5.9

- List of all members, including inherited members

## Methods

- TouchEventSequence commit()
- TouchEventSequence move(int touchId, object item, real x, real y)
- TouchEventSequence press(int touchId, object item, real x, real y)
- TouchEventSequence release(int touchId, object item, real x, real y)
- TouchEventSequence stationary(int touchId)

## Detailed Description

A TouchEventSequence is created by calling TestCase.touchEvent(). The type can not be directly instantiated. Each method provided by the type returns the same object, allowing chained calls.

For example:

      touchEvent(item).press(0).commit();

is equivalent to:

      var sequence = touchEvent(item);
      sequence.press(0);
      sequence.commit();

Events are delivered to the window which contains the item specified in touchEvent.

See also TestCase::touchEvent() and QTest::QTouchEventSequence.

## Method Documentation

TouchEventSequence commit()

Sends the touch event composed by prior use of press(), move(), release(), and stationary(). Following commit's return, the TouchEventSequence can be used to compose a new event.

      var sequence = touchEvent(target);
      // Touch the middle of target with 1 point
      sequence.press(1);
      sequence.commit();

      // Begin a new event
      // Move the point to target's upper left corner
      sequence.move(1, target, 0, 0);
      sequence.commit();

Commit is automatically invoked when the TouchEventSequence object is destroyed.

TouchEventSequence move(int touchId, object item, real x = item.width / 2, real y = item.height / 2)

Moves touchId to the point indicated by x and y relative to item.

Item defaults to the value provided via touchEvent(). X and y default to the midpoint of the item.

TouchEventSequence press(int touchId, object item, real x = item.width / 2, real y = item.height / 2)

Creates a new point identified as touchId, at the point indicated by x and y relative to item. Further use of the same touch point should maintain the same touchId.

Item defaults to the value provided via touchEvent(). X and y default to the midpoint of the item.

TouchEventSequence release(int touchId, object item, real x = item.width / 2, real y = item.height / 2)

Removes touchId at the point indicated by x and y relative to item.

Item defaults to the value provided via touchEvent(). X and y default to the midpoint of the item.

TouchEventSequence stationary(int touchId)

Indicates that touchId is present but otherwise unchanged from prior events.