QGestureEvent Class
QGestureEvent 类提供了对触发手势的描述。更多
| 头文件： | #include <QGestureEvent> |
| CMake.QGestureEvent | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承： | QEvent |
- 所有成员（包括继承成员）的列表
- QGestureEvent 属于事件类。
公共函数
| QGestureEvent(const QList<QGesture *> &gestures) | |
| virtual | ~QGestureEvent() |
| void | accept(QGesture *gesture) |
| void | accept(Qt::GestureType gestureType) |
| QList<QGesture *> | activeGestures() const |
| QList<QGesture *> | canceledGestures() const |
| QGesture * | gesture(Qt::GestureType type) const |
| QList<QGesture *> | gestures() const |
| void | ignore(QGesture *gesture) |
| void | ignore(Qt::GestureType gestureType) |
| bool | isAccepted(QGesture *gesture) const |
| bool | isAccepted(Qt::GestureType gestureType) const |
| QPointF | mapToGraphicsScene(const QPointF &gesturePoint) const |
| void | setAccepted(QGesture *gesture, bool value) |
| void | setAccepted(Qt::GestureType gestureType, bool value) |
| QWidget * | widget() const |
详细说明
QGestureEvent 类包含一个手势列表，可通过gestures() 函数获取。
这些手势要么处于激活状态，要么已被取消。使用activeGestures() 函数可获得当前正在执行的手势列表。使用canceledGestures() 函数可以获取之前激活但已取消的手势列表。如果当前窗口失去焦点、超时或其他原因，手势可能会被取消。
如果事件处理程序没有通过调用通用QEvent::accept() 函数来接受事件，那么所有未被接受且处于Qt::GestureStarted 状态的单个QGesture 对象都将沿着父窗口部件链向上传播，直到某个窗口部件通过为每个窗口部件调用QGestureEvent::accept() 来单独接受它们，或者某个事件过滤器消耗了该事件。
更多阅读
有关 Qt 中手势处理的概述以及在应用程序中使用手势的信息，请参阅《部件和图形视图中的手势》（Gestures in Widgets and Graphics View）文档。
另请参阅 QGesture,QGestureRecognizer,QWidget::grabGesture() 和QGraphicsObject::grabGesture() 。
成员函数文档
[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)
创建包含gestures 列表的新 QGestureEvent。
[virtual noexcept] QGestureEvent::~QGestureEvent()
销毁QGestureEvent 。
void QGestureEvent::accept(QGesture *gesture)
设置gesture 对象的接受标志，相当于调用setAccepted(gesture, true)。
设置接受标志表示事件接收者想要该手势。不想要的手势可能会传播到父部件。
另请参阅 QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
设置给定gestureType 的接受标志，相当于调用setAccepted(gestureType, true)。
设置接受标志表示事件接收者想要该手势。不想要的手势可能会传播到父部件。
另请参阅 QGestureEvent::ignore().
QList<QGesture *> QGestureEvent::activeGestures() const
返回活动（未取消）手势的列表。
QList<QGesture *> QGestureEvent::canceledGestures() const
返回已取消手势的列表。
QGesture *QGestureEvent::gesture(Qt::GestureType type) const
通过type 返回手势对象。
QList<QGesture *> QGestureEvent::gestures() const
返回事件中传递的所有手势。
void QGestureEvent::ignore(QGesture *gesture)
清除gesture 对象的接受标志参数，相当于调用setAccepted(gesture, false)。
清除接受标志表示事件接收者不需要该手势。不想要的手势可能会传播到父部件。
另请参阅 QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
清除给定gestureType 的接受标志参数，相当于调用setAccepted （gesture, false）。
清除接受标志表示事件接收者不需要该手势。不想要的手势可能会传播到父部件。
另请参阅 QGestureEvent::accept().
bool QGestureEvent::isAccepted(QGesture *gesture) const
如果gesture 被接受，则返回true ；否则返回false 。
bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const
如果接受gestureType 类型的手势，则返回true ；否则返回false 。
QPointF QGestureEvent::mapToGraphicsScene(const QPointF &gesturePoint) const
如果gesturePoint 位于图形视图内，则返回场景本地坐标。
当手势事件传送到QGraphicsObject 时，该功能可能会有用，可将屏幕坐标中的点转换为场景本地坐标。
另请参阅 QPointF::isNull().
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
将给定gesture 对象的接受标志设置为指定的value 。
设置接受标志表示事件接收者希望得到gesture 。不需要的手势可能会传播到父部件。
默认情况下，接受QEvent::Gesture 类型事件中的手势，忽略QEvent::GestureOverride 事件中的手势。
为方便起见，也可通过accept （手势）设置接受标志，通过ignore （手势）清除接受标志。
另请参阅 isAccepted().
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
将给定gestureType 对象的接受标志设置为指定的value 。
设置接受标志表示事件接收器希望接收指定类型的手势，gestureType 。不想要的手势可能会传播到父部件。
默认情况下，接收QEvent::Gesture 类型事件中的手势，忽略QEvent::GestureOverride 事件中的手势。
为方便起见，也可通过accept(gestureType) 设置接受标志，通过ignore(gestureType) 清除接受标志。
QWidget *QGestureEvent::widget() const
返回发生事件的部件。
© 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.
