滚动效果

在 1.7.0 版本加入.

基于 kinetic 效果,ScrollEffect 将运动限制在其 minmax 属性所确定的边界内。如果运动超出这些边界,它将计算 overscroll 的量,并尝试返回到其中一个边界的值。

这对于实现滚动列表非常有用。我们实际上将这个类作为我们 ScrollView 控件的基础效果来使用。

class kivy.effects.scroll.ScrollEffect(**kwargs)[源代码]

基类:KineticEffect

ScrollEffect 类。更多信息请参阅模块文档。

displacement

交互过程中移动的累计距离。该值用于判断移动是否构成拖拽(超过 drag_threshold)或非拖拽。

displacement 是一个 NumericProperty,默认值为 0。

drag_threshold

移动被认定为拖拽前所需的最小移动距离。

drag_threshold 是一个 NumericProperty,默认值为 20sp。

max

滚动使用的最大边界。

max 是一个 NumericProperty,默认值为 0。

min

滚动使用的最小边界。

min 是一个 NumericProperty,默认值为 0。

overscroll

用户过度滚动(即超出边界)时的计算值。

overscroll 是一个 NumericProperty,默认值为 0。

reset(pos)[源代码]

(内部)将值和速度重置为 pos。主要用于检查边界时。

scroll

滚动计算值。此值与 kivy.effects.kinetic.KineticEffect.value 不同,因为它会返回到最小/最大边界之一。

scroll 是一个 NumericProperty,默认值为 0。

start(val, t=None)[源代码]

开始移动。

参数:
val:浮点数或整数

移动的值

t:浮点数,默认为 None

移动发生的时间。如果未设置时间,将使用time.time()。

stop(val, t=None)[源代码]

停止移动。

参数请参见 start()

target_widget

附加到此效果上的部件。即使此类默认不会对`target_widget`进行更改,子类仍可使用它来修改图形或应用自定义变换。

target_widget 是一个 ObjectProperty,默认值为 None。

update(val, t=None)[源代码]

更新移动。

参数请参见 start()