Kivy - Spinner 小部件

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

Kivy 框架中的 Spinner 控件是一种更传统的下拉控件，不同于 Kivy 的 DropDown 小部件。与 DropDown 相比，Spinner 小部件的构建和使用更加简单方便。

Kivy 的下拉小部件和 Spinner 小部件之间的主要区别在于，下拉小部件可能由任何其他 Kivy 小部件组成，例如标签、按钮、图像等；而 Spinner 只是一个字符串列表。

Spinner 类在"kivy.uix.spinner"模块中定义

from kivy.uix.spinner import Spinner
spin = Spinner(**kwargs)

Spinner 小部件显示与当前选定值相对应的文本标题。可以使用不同的属性作为关键字参数来构造 Spinner 对象。但是，这两个属性很重要 −

text 属性是一个字符串，显示默认值。
values 属性是一个 ListProperty，包含所有可供选择的值。

要构建一个简单的微调器，请使用以下代码片段 −

from kivy.base import runTouchApp
from kivy.uix.spinner import Spinner

spinner = Spinner(
   text='English',
   values=('English', 'French', 'German', 'Chinese')
)

微调器对象的文本属性可以绑定到回调，以便在做出选择时调用适当的操作。

def value_changed(spinner, text):
   print(You selected', text, 'language')
   
spinner.bind(text=show_selected_value)

Spinner 类中的其他属性列于下方 −

dropdown_cls − 用于在按下 Spinner 时显示下拉列表的类。它是一个 ObjectProperty，默认为 DropDown。
is_open − 默认情况下，微调器未打开。设置为 True 可将其打开。
option_cls − 用于在 Spinner 下显示的下拉列表中显示选项的类。该类的 text 属性将用于表示值。其 on_release 事件用于在按下/触摸时触发选项。
text_autoupdate − 这是 BooleanProperty。它指示是否应使用 values 属性的第一个值自动更新微调器的文本。将其设置为 True 将导致微调器在每次更改值时更新其文本属性。
值 − 用户可以选中的值。它必须是字符串列表。它是一个 ListProperty，默认为 []。

下面的代码组装了一个 Spinner，与一个标签相关联，以在水平框中显示选定的值。下方水平框有一个 TextInput 和一个按钮。目的是在此按钮上提供回调，将文本框中的字符串添加到 Spinner 值中

该程序在 App 类中有两个回调方法。一个用于显示从微调器中选择的值，另一个用于向微调器添加新语言。

添加新语言的回调 −

def addvalue(self, instance):
	self.spin1.values.append(self.t1.text)

我们将此方法绑定到"添加"按钮。

要在标签上显示所选语言 −

def on_spinner_select(self, spinner, text):
	self.spinnerSelection.text = "所选语言是：%s" %self.spin1.text

我们将此方法绑定到 Spinner 的"text"属性小部件。

示例

将以下代码保存为"spiinerdemo.py"并运行

from kivy.app import App
from kivy.uix.label import Label
from kivy.uix.spinner import Spinner
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.textinput import TextInput
from kivy.uix.button import Button
from kivy.core.window import Window

Window.size = (720, 400)

class SpinnerExample(App):
   def addvalue(self, instance):
      self.spin1.values.append(self.t1.text)
      
   def build(self):
      layout = BoxLayout(orientation='vertical')
      lo1 = BoxLayout(orientation='horizontal')
      self.spin1 = Spinner(
         text="Python",
         values=("Python", "Java", "C++", "C", "C#", "PHP"),
         background_color=(0.784, 0.443, 0.216, 1),
         size_hint=(.5, .4), pos_hint={'top': 1}
      )
      lo1.add_widget(self.spin1)
      self.spinnerSelection = Label(
         text="Selected value in spinner is: %s" % self.spin1.text,
         pos_hint={'top': 1, 'x': .4}
      )
      lo1.add_widget(self.spinnerSelection)
      layout.add_widget(lo1)
      lo2 = BoxLayout(orientation='horizontal')
      lo2.add_widget(Label(text="Add Language"))
      self.t1 = TextInput()
      
      self.b1 = Button(text='add')
      lo2.add_widget(self.t1)
      lo2.add_widget(self.b1)
      layout.add_widget(lo2)
      self.spin1.bind(text=self.on_spinner_select)
      self.b1.bind(on_press=self.addvalue)
      return layout
      
   def on_spinner_select(self, spinner, text):
      self.spinnerSelection.text = "Selected value in spinner is: %s" % self.spin1.text
      print('The spinner', spinner, 'have text', text)

if __name__ == '__main__':
   SpinnerExample().run()