PySide6.QtWidgets.QGesture¶

class QGesture¶

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

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

在版本4.6中添加。

概要¶

属性¶

• gestureCancelPolicyᅟ - 决定接受手势时发生什么的策略

• 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中手势处理的概述以及如何在您的应用程序中使用手势的信息，请参阅Gestures in 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可以自动取消属于其他目标的其他手势。该策略通常设置为不取消任何其他手势，并且可以设置为取消上下文中的所有活动手势。例如，对于所有子部件。

Access functions:

• gestureCancelPolicy()

• setGestureCancelPolicy()

property gestureTypeᅟ: Qt.GestureType¶

此属性保存手势的类型。

Access functions:

• gestureType()

property hasHotSpotᅟ: bool¶

此属性表示手势是否具有热点。

Access functions:

• hasHotSpot()

property hotSpotᅟ: QPointF¶

此属性保存用于查找手势事件接收器的点。

热点是全局坐标系中的一个点，使用mapFromGlobal()或mapToGraphicsScene()来获取本地热点。

热点应该由手势识别器设置，以允许手势事件传递到QGraphicsObject。

Access functions:

• hotSpot()

• setHotSpot()

• unsetHotSpot()

property stateᅟ: Qt.GestureState¶

此属性保存手势的当前状态。

Access functions:

• state()

__init__([parent=None])¶

Parameters:

父对象 – QObject

使用给定的parent构造一个新的手势对象。

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

gestureCancelPolicy()¶

Return type:

GestureCancelPolicy

另请参阅

setGestureCancelPolicy()

属性 gestureCancelPolicyᅟ 的获取器。

gestureType()¶

Return type:

GestureType

属性 gestureTypeᅟ 的获取器。

hasHotSpot()¶

Return type:

布尔

属性 hasHotSpotᅟ 的获取器。

hotSpot()¶

Return type:

QPointF

另请参阅

setHotSpot()

属性 hotSpotᅟ 的获取器。

setGestureCancelPolicy(policy)¶

Parameters:

策略 – GestureCancelPolicy

另请参阅

gestureCancelPolicy()

属性 gestureCancelPolicyᅟ 的设置器。

setHotSpot(value)¶

Parameters:

值 – QPointF

另请参阅

hotSpot()

属性 hotSpotᅟ 的设置器。

state()¶

Return type:

GestureState

属性 stateᅟ 的获取器。

unsetHotSpot()¶

属性hotSpotᅟ的重置功能。