QTest::QTouchEventWidgetSequence Class
class QTest::QTouchEventWidgetSequenceQTouchEventWidgetSequence 类用于为小部件模拟一系列触摸事件。更多内容...
| 头文件： | #include <qtestsupport_widgets.h> |
| 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) |
详细说明
要模拟控件上的一系列触摸事件，请调用QTest::touchEvent()，并传入指向QWidget 实例的指针。通过调用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 时提供的控件的位置。
模拟用户移动了由touchId 标识的指尖。
QTest::QTouchEventWidgetSequence &QTouchEventWidgetSequence::press(int touchId, const QPoint &pt, QWidget *widget = nullptr)
向该序列添加一个针对位置pt 的触点touchId 的按压事件，并返回对该QTouchEventWidgetSequence 的引用。
位置pt 被解释为相对于widget 。如果widget 是空指针，则pt 被解释为相对于实例化此QTouchEventWidgetSequence 时提供的控件。
模拟用户使用由touchId 标识的指尖点击触摸屏或触控板。
QTest::QTouchEventWidgetSequence &QTouchEventWidgetSequence::release(int touchId, const QPoint &pt, QWidget *widget = nullptr)
向该序列添加一个位于位置pt 的触点touchId 的释放事件，并返回对此QTouchEventWidgetSequence 的引用。
位置pt 被解释为相对于widget 。如果widget 是空指针，则pt 被解释为相对于实例化此QTouchEventWidgetSequence 时提供的控件。
模拟用户抬起了由touchId 标识的指尖。
© 2026 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.
