class QGesture

QGesture 类表示一个手势，包含描述相应用户输入的属性。 更多…

继承自： QTapGesture、QTapAndHoldGesture、QSwipeGesture、QPinchGesture、QPanGesture

自版本 4.6 新增。

概要

属性

• gestuceCancelPolicy - 接受手势时的策略

• gestureType - 手势类型

• hasHotSpot - 手势是否有热点

• hotSpot - 用于查找手势事件接收器的点

• state -手势的当前状态

方法

• def __init__()

• def gestureCancelPolicy()

• def gestureType()

• def hasHotSpot()

• def hotSpot()

• def setGestureCancelPolicy()

• def setHotSpot()

• def state()

• def unsetHotSpot()

注意

此文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建一个问题来通知我们。

详细描述

手势对象不由开发人员直接构建。它们是由与应用程序一起注册的QGestureRecognizer对象创建的；见registerRecognizer()。

有关Qt中手势处理的概述以及有关在您的应用程序中使用手势的信息，请参阅Widgets and Graphics View中的手势文档。

手势属性

该类有一系列属性，用户可以通过它们查询特定手势的参数。例如，捏合手势有一个作为属性公开的缩放因子。

自定义手势识别器的开发人员可以通过向QGesture对象添加新动态属性或通过继承QGesture类（或其子类）来添加额外的属性，以提供有关手势的更多信息。

手势对象的生命周期

在需要时，将隐式创建一个 QGesture 实例，该实例由 Qt 管理。开发者不应销毁它们或存储它们供以后使用，因为 Qt 可能会销毁特定实例并创建新的实例来替换它们。

已注册的手势识别器通过其 recognize() 函数监视目标对象的输入事件，根据需要更新手势对象属性。

如果对应的手势处于活动状态或刚刚取消，则手势对象将通过 QGestureEvent 传递给目标对象。传递的每个事件都包含手势对象列表，因为可以为目标对象启用对多个手势的支持。由于 Qt 中事件的处理方式，手势事件可能被其他对象过滤。

另请参阅

QGestureEvent QGestureRecognizer

class GestureCancelPolicy

此枚举描述了接受手势如何自动取消其他手势。

常量	描述
QGesture.CancelNone	接受此手势时，不会影响其他手势。
QGesture.CancelAllInContext	在上下文中接受此手势时，将取消所有活动的手势（尊重在订阅手势时指定的 Qt::GestureFlag）。

注意

可以使用 from __feature__ import true_property 时直接使用属性，否则通过访问器函数使用。

property gestureCancelPolicyᅟ: QGesture.GestureCancelPolicy

此属性保留接受一个手势时发生的策略。

在接受一个手势后，Qt 可以自动取消属于其他目标的组手势。策略通常设置为不取消任何其他手势，并可以设置为取消上下文中所有活动的手势。例如，对于所有子小部件。

访问函数

• gestureCancelPolicy()

• setGestureCancelPolicy()

property gestureTypeᅟ: Qt.GestureType

此属性保留手势的类型。

访问函数

• gestureType()

property hasHotSpotᅟ: bool

此属性保留了手势是否有热点。

访问函数

• hasHotSpot()

属性 hotSpot: QPointF

此属性包含用于定位手势事件的接收器的点。

热区是全局坐标系中的一个点，可以使用《mapFromGlobal()》或《mapToGraphicsScene()》获取局部热区。

热区应由手势识别器设置，以便将手势事件传递给《QGraphicsObject》。

访问函数

• hotSpot()

• setHotSpot()

• unsetHotSpot()

属性 state: Qt.GestureState

此属性包含手势的当前状态。

访问函数

• state()

__init__([parent=None])

参数：

parent – 《QObject》

使用指定的《parent》构造一个新手势对象。

《create()》函数在手势识别器中创建《QGesture》对象。

gestureCancelPolicy()

返回类型：

GestureCancelPolicy

另请参阅

setGestureCancelPolicy()

属性《gestureCancelPolicy》的获取器。

gestureType()

返回类型：

GestureType

属性《gestureType》的获取器。

hasHotSpot()

返回类型：

bool

属性《hasHotSpot》的获取器。

hotSpot()

返回类型：

QPointF

另请参阅

setHotSpot()

属性《hotSpot》的获取器。

setGestureCancelPolicy(policy)

参数：

policy – GestureCancelPolicy

另请参阅

gestureCancelPolicy()

设置属性 gestureCancelPolicy 的值。

setHotSpot(value)

参数：

value – QPointF

另请参阅

hotSpot()

设置属性 hotSpot 的值。

state()

返回类型：

GestureState

获取属性 state 的值。

unsetHotSpot()

属性 hotSpot 的重置函数。