TouchEventSequence QML Type

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

Import Statement: import QtTest 1.12
Since: Qt 5.9

Methods

  • TouchEventSequence commit()
  • TouchEventSequence move(int touchId, object item, real x = item.width / 2, real y = item.height / 2)
  • TouchEventSequence press(int touchId, object item, real x = item.width / 2, real y = item.height / 2)
  • TouchEventSequence release(int touchId, object item, real x = item.width / 2, real y = item.height / 2)
  • 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().

Method Documentation

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.


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