PySide6.QtWidgets.QScrollerProperties

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速度所需的时间。实际值取决于所选的ScrollingCurve。对于大多数类型，该值应在0.1到2.0的范围内

QScrollerProperties.MinimumVelocity

在结束触摸或释放鼠标后，开始滚动所需的最小速度，单位为m/s。

QScrollerProperties.MaximumVelocity

这是可以达到的最大速度，单位为m/s。

QScrollerProperties.MaximumClickThroughVelocity

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

QScrollerProperties.AcceleratingFlickMaximumTime

这是识别为加速轻弹手势的最大时间，单位为秒。如果设置为零，则不会检测到此类手势。“加速轻弹”是在已经滚动的对象上执行的轻弹手势。在这种情况下，滚动速度会乘以AcceleratingFlickSpeedupFactor以加速滚动。

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)
Parameters:

sp – QScrollerProperties

构造 sp 的副本。

__ne__(sp)
Parameters:

sp – QScrollerProperties

Return type:

布尔

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

__eq__(sp)
Parameters:

sp – QScrollerProperties

Return type:

布尔

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

scrollMetric(metric)
Parameters:

metric – ScrollMetric

Return type:

对象

查询滚动条属性的metric值。

static setDefaultScrollerProperties(sp)
Parameters:

sp – QScrollerProperties

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

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

注意

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

另请参阅

unsetDefaultScrollerProperties()

setScrollMetric(metric, value)
Parameters:

将metric ScrollerMetric的特定值设置为value。

static unsetDefaultScrollerProperties()

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