Snapshot of one script/UI touch item in the shared gesture queue.
Syntax
TouchState(id, status, kind, action_order, remaining_repeats, completed_repeats)This class cannot be constructed directly.
Parameters
None
Returns
—Behavior / side effects
Snapshot of one script/UI touch item in the shared gesture queue.
Execution
- Blocking: Conditional
- Thread safety: Not guaranteed
- Parallel execution: Conditional
Execution cost and waits depend on the documented operation. Keep mutable values in their owning flow; sharing arbitrary objects between flows has no general thread-safety guarantee.
Example
# TouchState values come from a touch-state query; do not construct them
Touch.collect()
click((300, 900), hold_ms=1000, parallel=True)
Touch.send()
for state in Touch.all():
print(state.id, state.status, state.kind)
Touch.wait()Errors / limitations
No additional limitations documented; follow the parameter and behavior contract above.
Related APIs
None
Fields
| Name | Description |
|---|---|
idNumber | Touch submission id. |
statusString | queued, active, completed, cancelled, or failed. |
kindString | Touch kind such as click or swipe. |
action_orderNumber | Owning action order. |
remaining_repeatsNumber | Repeats still queued. Default: 0 |
completed_repeatsNumber | Repeats already completed. Default: 0 |