class QScrollerProperties#

类 QScrollerProperties 存储了用于 QScroller 的设置。 更多...

概要

方法

静态函数

注意

此文档可能包含从C++自动翻译成Python的代码片段。我们总是欢迎对片段翻译的贡献。如果你发现翻译有问题，你还可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来通知我们。

详细描述#

QScrollerProperties类存储了由QScroller使用的参数。

默认设置取决于平台，因此Qt模拟了平台行为的动能滚动。

按照惯例，QScrollerProperties以物理单位（米，秒）表示，并由QScroller使用当前DPI进行转换。

另请参阅

QScroller

class OvershootPolicy#

此枚举描述了各种超出的模式。

常量

描述

QScrollerProperties.OvershootWhenScrollable

当内容可滚动时可以进行超出。这是默认设置。

QScrollerProperties.OvershootAlwaysOff

超出始终未启用，即使内容可滚动。

QScrollerProperties.OvershootAlwaysOn

超出始终启用，即使内容不可滚动。
class FrameRates#

此枚举描述了在拖动或滚动时使用的可用帧率。

常量

描述

QScrollerProperties.Fps60

每秒60帧

QScrollerProperties.Fps30

每秒30帧

QScrollerProperties.Fps20

每秒20帧

QScrollerProperties.Standard

默认值为每秒60帧（对应于QAbstractAnimation）。
class ScrollMetric#

此枚举包含不同的滚动度量类型。除非另有说明，否则setScrollMetric函数期望一个类型为qreal的QVariant。

请参阅QScroller文档以获取有关不同值背后的概念的更详细信息。

常量

描述

QScrollerProperties.MousePressEventDelay

这是在[s]中开始一个滑动手势时鼠标按下事件的延迟时间。如果在那个时间内触发手势，则不会向滚动对象发送鼠标按下或释放事件。如果在该延迟后触发，则发送延迟的鼠标按下事件以及全局位置为QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX)的模拟释放事件。如果手势被取消，则发送延迟的鼠标按下事件以及实际的释放事件。

QScrollerProperties.DragStartDistance

在m中，这是触发滑动手势之前触摸点或鼠标点需要移动的最小距离。

QScrollerProperties.DragVelocitySmoothingFactor

一个值，描述了新拖动速度在最终滚动速度中的包含程度。此值应在0到1之间。值越低，拖动速度的平滑度就越高。

QScrollerProperties.AxisLockThreshold

如果移动位于轴周围的角度内，将限制移动到一个轴。阈值必须在0到1之间。

QScrollerProperties.ScrollingCurve

在用户初始化滑动后减速滚动速度时使用的QEasingCurve。请注意，这是位置而不是速度的缓和曲线：默认为QEasingCurve::OutQuad，这将导致速度（一阶导数）的线性减少和恒定的减速（二阶导数）。

QScrollerProperties.DecelerationFactor

此因素影响滚动器减速到0速度所需的时间。实际值取决于所选的滚动曲线。对于大多数类型，值应在0.1到2.0之间。

QScrollerProperties.MinimumVelocity

结束触摸或释放鼠标后所需的最低速度，以m/s表示，以便开始滚动。

QScrollerProperties.MaximumVelocity

这是可以达到的最大速度，以m/s表示。

QScrollerProperties.MaximumClickThroughVelocity

这是点击穿透允许的最大滚动速度，以m/s表示。这意味着在当前（缓慢）滚动对象上的点击不仅会停止滚动，还会将点击事件传递到UI控件。这在使用指数型滚动曲线时非常有用。

QScrollerProperties.AcceleratingFlickMaximumTime

一个滑动手势被识别为加速滑动所能持续的最长时间（以秒为单位）。如果设置为0，则不会检测到此类手势。“加速滑动”是在已经滚动对象上执行的滑动手势。在这种情况下，滚动速度将乘以加速滑动加速因子，以加快速度。

QScrollerProperties.AcceleratingFlickSpeedupFactor

检测到加速滑动时，当前速度将乘以这个数。应该是>= 1。

QScrollerProperties.SnapPositionRatio

这是用户必须拖动两个捕捉点之间区域以将其捕捉到下一个位置的距离。0.33表示滚动只需达到两个捕捉点之间距离的三分之一即可捕捉到下一个点。比率必须在0和1之间。

QScrollerProperties.SnapTime

这是滚动曲线的时间因素。值越低，滚动所需时间就越长。滚动距离不依赖于此值。

QScrollerProperties.OvershootDragResistanceFactor

这是鼠标拖动和实际滚动区域（在超出时）之间的因子。该因素必须在0到1之间。

QScrollerProperties.OvershootDragDistanceFactor

这是在拖动时超出移动的最大距离。实际超出距离是通过将此值乘以滚动对象的可视窗口大小来计算的。该因素必须介于 0 和 1 之间。

QScrollerProperties.OvershootScrollDistanceFactor

这是在滚动时的最大超出距离。实际超出距离是通过将此值乘以滚动对象的可视窗口大小来计算的。该因素必须在 0 和 1 之间。

QScrollerProperties.OvershootScrollTime

这是播放完整超出动画所需的时间（以秒为单位）。

QScrollerProperties.HorizontalOvershootPolicy

这是水平超出策略（请参见 OvershootPolicy）。

QScrollerProperties.VerticalOvershootPolicy

这是水平超出策略（请参见 OvershootPolicy）。

QScrollerProperties.FrameRate

这是拖动或滚动时应使用的帧率。内部，QScroller 使用 QAbstractAnimation 计时器来同步所有滚动操作与可能同时活动的其他动画。如果每秒60帧的标准值太快，可以通过此设置将其降低，同时保持与 QAbstractAnimation 同步。请注意，只能使用 FrameRates 枚举中的值。

QScrollerProperties.ScrollMetricCount

这总是最后一个条目。
__init__()#

构建新的滚动属性。

__init__(sp)
参数：

sp – QScrollerProperties

构建 sp 的副本。

__ne__(sp)#
参数：

sp – QScrollerProperties

返回类型：

bool

如果这些滚动属性与 sp 不同，则返回 true；否则返回 false。

__eq__(sp)#
参数：

sp – QScrollerProperties

返回类型：

bool

如果这些滚动属性与 sp 相等，则返回 true；否则返回 false。

scrollMetric(metric)#
参数：

指标 – ScrollMetric

返回类型：

对象

查询滚动属性中的metric值。

静态 setDefaultScrollerProperties(sp)#
参数：

sp – QScrollerProperties

将所有新的QScrollerProperties对象设置回sp滚动属性。

使用此函数来覆盖默认构造函数返回的平台默认属性。如果您只想修改单个滚动条属性的滚动属性，请使用setScrollerProperties()

注意

调用此函数不会更改已存在的QScrollerProperties对象的内容。

另请参阅

unsetDefaultScrollerProperties()

setScrollMetric(metric, value)#
参数：

将滚动器指标metric的特定值设置为value。

静态 unsetDefaultScrollerProperties()#

将默认构造函数返回的滚动属性设置回平台默认属性。