Kivy - 效果

更新于 2024/6/13 10:47:55

Kivy 库提供了"kivy.effects"子包，用于在 Kivy 应用中使用 ScrollView 小部件时控制过度滚动效果。效果类可以执行诸如弹回、更改不透明度或防止超出正常边界的滚动等操作。

有三个效果类 −

ScrollEffect − 用于实现效果的基类。它仅计算滚动和过度滚动。此类在 kivy.effects.scroll 模块中定义
DampedScrollEffect − 使用过度滚动信息允许用户拖动超过预期的量。一旦用户停止拖动，位置就会返回到其中一个边界。此类的定义位于 kivy.effects.dampedscroll 模块中。
OpacityScrollEffect − 使用过度滚动信息来降低 scrollview 小部件的不透明度。当用户停止拖动时，不透明度将重新设置为 1。该类定义可在 kivy.effects.opacityscroll 模块中找到。

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

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

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

示例

以下"kv"语言脚本构建了一个 ScrollView，并在 GridLayout 中添加了一百个按钮。"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()