PySide6.QtWidgets.QGestureEvent

class QGestureEvent

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

PySide6.QtWidgets.QGestureEvent 的继承图

在版本4.6中添加。

概要

方法

注意

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

详细描述

QGestureEvent 类包含一个手势列表，可以使用 gestures() 函数获取。

手势要么是活动的，要么是被取消的。可以使用activeGestures()函数获取当前正在执行的手势列表。可以使用canceledGestures()函数访问之前活动但已被取消的手势列表。手势可能会因为当前窗口失去焦点、超时或其他原因而被取消。

如果事件处理程序没有通过调用通用的QEvent::accept()函数接受事件，所有未被接受且处于Qt::GestureStarted状态的单个QGesture对象将会沿着父部件链向上传播，直到某个部件通过为每个对象调用accept()单独接受它们，或者事件过滤器消耗了该事件。

进一步阅读

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

__init__(gestures)
Parameters:

gestures – QGesture 的列表

创建包含gestures列表的新QGestureEvent。

accept(gesture)
Parameters:

手势 – QGesture

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

设置接受标志表示事件接收器希望接收手势。不需要的手势可能会传播到父部件。

另请参阅

ignore()

accept(gestureType)
Parameters:

gestureType – GestureType

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

设置接受标志表示事件接收器想要这个手势。不需要的手势可能会传播到父部件。

另请参阅

ignore()

activeGestures()
Return type:

QGesture的列表

返回一个活动（未取消）手势的列表。

canceledGestures()
Return type:

QGesture的列表

返回已取消的手势列表。

gesture(type)
Parameters:

类型 – GestureType

Return type:

QGesture

通过type返回一个手势对象。

gestures()
Return type:

QGesture的列表

返回事件中传递的所有手势。

ignore(gesture)
Parameters:

手势 – QGesture

清除给定gesture对象的接受标志参数，相当于调用setAccepted(gesture, false)。

清除接受标志表示事件接收者不希望接收该手势。不需要的手势可能会传播到父部件。

另请参阅

accept()

ignore(gestureType)
Parameters:

gestureType – GestureType

清除给定gestureType的接受标志参数，相当于调用setAccepted(gesture, false)。

清除接受标志表示事件接收者不希望接收该手势。不需要的手势可能会传播到父部件。

另请参阅

accept()

isAccepted(gesture)
Parameters:

手势 – QGesture

Return type:

布尔

如果gesture被接受，则返回true；否则返回false。

isAccepted(gestureType)
Parameters:

gestureType – GestureType

Return type:

布尔

如果类型为gestureType的手势被接受，则返回true；否则返回false。

mapToGraphicsScene(gesturePoint)
Parameters:

gesturePoint – QPointF

Return type:

QPointF

如果gesturePoint在图形视图内，则返回场景局部坐标。

当手势事件传递给QGraphicsObject时，此功能可能很有用，用于将屏幕坐标中的点转换为场景局部坐标。

另请参阅

isNull()

setAccepted(gesture, value)
Parameters:

  • 手势 – QGesture

  • value – 布尔值

将给定的gesture对象的接受标志设置为指定的value。

设置接受标志表示事件接收者想要gesture。不需要的手势可能会传播到父部件。

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

为了方便起见，接受标志也可以通过accept(gesture)设置，并通过ignore(gesture)清除。

另请参阅

isAccepted()

setAccepted(gestureType, value)
Parameters:

将给定的gestureType对象的接受标志设置为指定的value。

设置接受标志表示事件接收器希望接收指定类型的手势，gestureType。不需要的手势可能会传播到父部件。

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

为了方便起见，接受标志也可以通过accept(gestureType)设置，并通过ignore(gestureType)清除。

setWidget(widget)
Parameters:

widget – QWidget

widget()
Return type:

QWidget

返回发生事件的小部件。