Kivy - 效果

Kivy 库提供 “kivy.effects” 子包来控制在 Kivy 应用中使用 ScrollView 组件时的滚动条溢出效果。Effect 类可以执行诸如反弹、更改不透明度或防止滚动超出正常边界等操作。

共有三个 Effect 类：

• ScrollEffect - 用于实现效果的基类。它只计算滚动和滚动溢出。此类定义在 kivy.effects.scroll 模块中。

• DampedScrollEffect - 使用滚动溢出信息允许用户比预期拖动更多。一旦用户停止拖动，位置将返回到边界之一。此类的定义在 kivy.effects.dampedscroll 模块中。

• OpacityScrollEffect - 使用滚动溢出信息来降低滚动视图组件的不透明度。当用户停止拖动时，不透明度将恢复为 1。此类的定义在 kivy.effects.opacityscroll 模块中。

这些类使用 KineticEffect 作为基类来计算运动中的速度。

要在 ScrollView 的滚动行为上应用这些类的任何效果，请将这些类中的一个设置为 ScrollView 组件的 effect_cls 属性的值。

scr = ScrollView(size=Window.size)
scr.eefect_cls=ScrollEffect

示例

下面的 “kv” 语言脚本构建一个 ScrollView，其中向 GridLayout 添加了 100 个按钮。“effect_cls” 属性设置为 ScrollEffect 类。

#:import ScrollEffect kivy.effects.scroll.ScrollEffect
#:import Button kivy.uix.button.Button
<RootWidget>
   effect_cls: ScrollEffect
   GridLayout:
   size_hint_y: None
   height: self.minimum_height
   cols: 1
   on_parent:
      for i in range(100):
self.add_widget(Button(text=str(i), size_hint_y=None))

上面的 “kv” 代码使用名为 RootWidget 的类规则。下面 Python 代码中 App 类的 build() 方法返回 RootWidget 类的对象。

from kivy.uix.gridlayout import GridLayout
from kivy.uix.button import Button
from kivy.uix.scrollview import ScrollView
from kivy.effects.dampedscroll import DampedScrollEffect
from kivy.core.window import Window
from kivy.app import App
from kivy.core.window import Window

Window.size = (720,350)

class RootWidget(ScrollView):
   pass
   
class scrollableapp(App):
   def build(self):
      return RootWidget()

scrollableapp().run()

输出

从命令行执行上述 Python 程序。您将获得一个带有滚动视图的应用程序窗口，显示按钮的快照。您可以使用激活的 ScrollEffect 上下滚动。

您可以通过在 RootWidget 类中指定属性来自定义 Effect 类，并将其用作 “effect_cls” 属性。

例如，您可以设置用于滚动的 max 和 min 边界。overscroll 属性是在用户滚动溢出（即超出边界）时计算的值。