QTest::QTouchEventWidgetSequence Class

class QTest::QTouchEventWidgetSequence

QTouchEventWidgetSequence 类用于模拟 widget 的触摸事件序列。更多

头文件: #include <QTouchEventWidgetSequence>
CMake: find_package(Qt6 REQUIRED COMPONENTS Test)
target_link_libraries(mytarget PRIVATE Qt6::Test)
qmake: QT += testlib
继承: QTest::QTouchEventSequence

公共函数

QTest::QTouchEventWidgetSequence &move(int touchId, const QPoint &pt, QWidget *widget = nullptr)
QTest::QTouchEventWidgetSequence &press(int touchId, const QPoint &pt, QWidget *widget = nullptr)
QTest::QTouchEventWidgetSequence &release(int touchId, const QPoint &pt, QWidget *widget = nullptr)

详细说明

要在 widget 上模拟触摸事件序列,请使用指向QWidget 实例的指针调用QTest::touchEvent() 。通过调用press(),move(),release() 和stationary() 将触摸事件添加到返回的 QTouchEventWidgetSequence 对象中,并让该实例运行出作用域,将序列提交到事件系统中。

成员函数文档

QTest::QTouchEventWidgetSequence &QTouchEventWidgetSequence::move(int touchId, const QPoint &pt, QWidget *widget = nullptr)

为位于pt 位置的触摸点touchId 添加一个移动事件到此序列,并返回对QTouchEventWidgetSequence 的引用。

pt 被解释为相对于widget 的位置。如果widget 是空指针,则pt 被解释为相对于实例化此QTouchEventWidgetSequence 时提供的 widget 的位置。

模拟用户移动由touchId 标识的手指。

QTest::QTouchEventWidgetSequence &QTouchEventWidgetSequence::press(int touchId, const QPoint &pt, QWidget *widget = nullptr)

在此序列中添加位置pt 的触摸点touchId 的按压事件,并返回对QTouchEventWidgetSequence 的引用。

pt 被解释为相对于widget 的位置。如果widget 是空指针,则pt 被解释为相对于实例化该QTouchEventWidgetSequence 时提供的 widget 的位置。

模拟用户用touchId 标识的手指按下触摸屏或触摸板。

QTest::QTouchEventWidgetSequence &QTouchEventWidgetSequence::release(int touchId, const QPoint &pt, QWidget *widget = nullptr)

在此序列中添加位置为pt 的触摸点touchId 的释放事件,并返回对QTouchEventWidgetSequence 的引用。

pt 被解释为相对于widget 的位置。如果widget 是空指针,则pt 被解释为相对于实例化该QTouchEventWidgetSequence 时提供的 widget 的位置。

模拟用户抬起由touchId 标识的手指。

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