QGestureEvent 类

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

头: #include <QGestureEvent>
qmake: QT += widgets
Since: Qt 4.6
继承: QEvent

该类在 Qt 4.6 引入。

公共函数

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 ().

成员函数文档编制

QGestureEvent:: QGestureEvent (const QList < QGesture *> & gestures )

创建新的 QGestureEvent 包含列表 gestures .

[虚拟] 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。

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

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

QWidget *QGestureEvent:: widget () const

返回事件在其中发生的 Widget。