QGestureEvent 类

QGestureEvent class provides the description of triggered gestures. 更多...

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

公共函数

QGestureEvent (const QList<QGesture *> & gestures )
~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 class provides the description of triggered gestures.

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 )

Creates new QGestureEvent containing a list of 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) .

Clearing the accept flag indicates that the event receiver does not want the gesture. Unwanted gestures may be propgated to the parent 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

Returns the scene-local coordinates if the gesturePoint is inside a graphics view.

This functional might be useful when the gesture event is delivered to a QGraphicsObject to translate a point in screen coordinates to scene-local coordinates.

另请参阅 QPointF::isNull ().

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

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

Setting the accept flag indicates that the event receiver wants the gesture . Unwanted gestures may be propagated to the parent widget.

By default, gestures in events of type QEvent::Gesture are accepted, and gestures in QEvent::GestureOverride events are ignored.

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

另请参阅 isAccepted ().

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

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

Setting the accept flag indicates that the event receiver wants to receive gestures of the specified type, gestureType . Unwanted gestures may be propagated to the parent widget.

By default, gestures in events of type QEvent::Gesture are accepted, and gestures in QEvent::GestureOverride events are ignored.

为方便起见,接受标志还可以被设置采用 accept (gestureType), and cleared with ignore (gestureType).

QWidget *QGestureEvent:: widget () const

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