TouchEventSequence QML Type
TouchEventSequence is used to build and dispatch touch events for testing. More...
| Import Statement: | import QtTest 1.15 |
| Since: | Qt 5.9 |
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().
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.