QGestureEvent 类

QGestureEvent 类提供触发手势的描述。更多...

头：	#include <QGestureEvent>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:	QT += widgets
继承：	QEvent

所有成员列表，包括继承成员
QGestureEvent is part of 事件类 .

公共函数

	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

详细描述

The QGestureEvent class contains a list of gestures, which can be obtained using the gestures () 函数。

手势要么活动，要么被取消。可以获得目前正执行的那些列表使用 activeGestures () 函数。可以访问先前活动并已被取消的那些列表使用 canceledGestures () 函数。手势可能被取消，例如，若当前窗口丢失聚焦，或因为超时或出于其它原因。

若事件处理程序不接受事件通过调用一般 QEvent::accept () 函数，所有单个 QGesture 对象不被接受和在 Qt::GestureStarted 状态将向上传播到父级 Widget 链，直到 Widget 单独接受它们为止，通过调用 QGestureEvent::accept () 对于它们中的每个，或事件过滤器消耗事件。

延伸阅读

Qt 中手势处理的概述和在应用程序中使用手势的有关信息，见 Widget 和图形视图中的手势文档。

另请参阅 QGesture , QGestureRecognizer , QWidget::grabGesture ()，和 QGraphicsObject::grabGesture ().

成员函数文档编制

`[explicit]` QGestureEvent:: QGestureEvent (const QList < QGesture > & gestures* )

创建新的 QGestureEvent 包含列表 gestures .

`[virtual noexcept]` QGestureEvent:: ~QGestureEvent ()

销毁 QGestureEvent .

void QGestureEvent:: accept ( QGesture * gesture )

设置接受标志为给定 gesture 对象，相当于调用 setAccepted (gesture, true).

设置接受标志指示事件接收者想要的手势。不想要的手势可能会被传播给父级 Widget。

另请参阅 QGestureEvent::ignore ().

void QGestureEvent:: accept ( Qt::GestureType gestureType )

设置接受标志为给定 gestureType ，相当于调用 setAccepted (gestureType, true).

设置接受标志指示事件接收者想要的手势。不想要的手势可能会被传播给父级 Widget。

另请参阅 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).

清零接受标志指示事件接收者不想要的手势。不想要的手势可能会被传播给父级 Widget。

另请参阅 QGestureEvent::accept ().

void QGestureEvent:: ignore ( Qt::GestureType gestureType )

清零接受标志参数为给定 gestureType ，相当于调用 setAccepted (gesture, false).

清零接受标志指示事件接收者不想要的手势。不想要的手势可能会被传播给父级 Widget。

另请参阅 QGestureEvent::accept ().

bool QGestureEvent:: isAccepted ( QGesture * gesture ) const

返回 true 若 gesture 被接受；否则返回 false .

bool QGestureEvent:: isAccepted ( Qt::GestureType gestureType ) const

返回 true 若手势的类型 gestureType 被接受；否则返回 false .

QPointF QGestureEvent:: mapToGraphicsScene (const QPointF & gesturePoint ) const

返回场景局部坐标若 gesturePoint 在图形视图内。

此功能可能有用，当手势事件被交付给 QGraphicsObject 以将屏幕坐标点翻译成场景局部坐标。

另请参阅 QPointF::isNull ().

void QGestureEvent:: setAccepted ( QGesture * gesture , bool value )

设置接受标志为给定 gesture 对象到指定 value .

设置接受标志指示事件接收者想要的 gesture 。不想要的手势可能会被传播给父级 Widget。

默认情况下，事件手势类型为 QEvent::Gesture 接受，和手势为 QEvent::GestureOverride 事件被忽略。

为方便起见，还可以设置接受标志采用 accept (gesture)，和清零采用 ignore (gesture).

另请参阅 isAccepted ().

void QGestureEvent:: setAccepted ( Qt::GestureType gestureType , bool value )

设置接受标志为给定 gestureType 对象到指定 value .

设置接受标志指示事件接收者想要接收的指定类型手势 gestureType 。不想要的手势可能会被传播给父级 Widget。