Kivy 简明教程

Kivy - Checkbox

在任何 GUI 工具包中，都使用复选框允许用户从可用选项中选择一个或多个。在 Kivy 中，CheckBox 可以配置为使选择互斥（仅可选择可用选项之一），或者允许用户标记任意数量的选择。

  1. 如果两个或更多复选框的 group 属性值相同，则它们显示为圆形单选按钮；用户只能选择一个选项，因为只有一个复选框的 active 属性可以为 True，对于其他属性，active 属性将自动变为 False。

  2. 对于没有 group 属性的复选框，它显示为一个矩形框，当按下时，显示一个复选标记，active 属性变为 True。再次单击它，并将删除复选标记，active 属性将变为 False。

CheckBox 类在 kivy.uix.checkbox 模块中定义

from kivy.uix.checkbox import CheckBox
cb = CheckBox(**kwargs)

如果复选框对象绑定到其 active 属性，则每次 active 属性更改时都将调用回调。

checkbox = CheckBox()
checkbox.bind(active=callback)

Example

以下 Python 代码展示了如何使用互斥以及多选复选框。

代码使用垂直 BoxLayout，其中包含两个水平布局和两个标签。上水平布局保留两个复选框，其 group 属性均为“sex”

self.m = CheckBox(group='sex', color=[1,0,1,1])
self.m.bind(active=self.on_male)
gendergrp.add_widget(self.m)
gendergrp.add_widget(Label(text='Female'))
self.f = CheckBox(active=False, group='sex')
self.f.bind(active=self.on_female)
gendergrp.add_widget(self.f)

这两个复选框都调用一个回调方法，该方法标识 active 属性。

下水平框保留三个独立复选框 −

interests.add_widget(Label(text='Sports'))
self.cb1 = CheckBox()
self.cb1.bind(active=self.on_interest)
interests.add_widget(self.cb1)

self.cb2 = CheckBox()
self.cb2.bind(active=self.on_interest)
interests.add_widget(Label(text='Music'))
interests.add_widget(self.cb2)

self.cb3 = CheckBox()
self.cb3.bind(active=self.on_interest)
interests.add_widget(Label(text='Travel'))
interests.add_widget(self.cb3)

单击这些复选框中的每一个时，都会建立和显示水平框下面标签上的已选择兴趣列表。

这是 complete code −

from kivy.app import App
from kivy.uix.label import Label
from kivy.uix.checkbox import CheckBox
from kivy.uix.boxlayout import BoxLayout
from kivy.core.window import Window

Window.size = (720,400)
class CheckBoxApp(App):
   gender=''
   intrst=[]
   def on_male(self, instance, value):
      if value:
         CheckBoxApp.gender='Male'
         self.lbl.text = "Gender selected: "+CheckBoxApp.gender
      else:
         self.lbl.text = "Gender selected: "
   def on_female(self, instance, value):
      if value:
         CheckBoxApp.gender='Female'
         self.lbl.text = "Gender selected: "+CheckBoxApp.gender
      else:
         self.lbl.text = "Gender selected: "
   def on_interest(self, instance, value):
      CheckBoxApp.intrst=[]
      if self.cb1.active:
         CheckBoxApp.intrst.append("Sports")
      if self.cb2.active:
         CheckBoxApp.intrst.append("Music")
      if self.cb3.active:
         CheckBoxApp.intrst.append("Travel")
      self.lbl1.text="Interests Selected: "+" ".join(CheckBoxApp.intrst)

   def build(self):
      main=BoxLayout(orientation='vertical')

      gendergrp=BoxLayout(orientation='horizontal')
      interests = BoxLayout(orientation='horizontal')

      gendergrp.add_widget(Label(text='Gender:'))
      gendergrp.add_widget(Label(text='Male'))
      self.m = CheckBox(group='sex', color=[1,0,1,1])
      self.m.bind(active=self.on_male)
      gendergrp.add_widget(self.m)
      gendergrp.add_widget(Label(text='Female'))
      self.f = CheckBox(active=False, group='sex')
      self.f.bind(active=self.on_female)

      gendergrp.add_widget(self.f)
      main.add_widget(gendergrp)
      self.lbl = Label(text="Gender selected: ", font_size=32)

      main.add_widget(self.lbl)

      interests.add_widget(Label(text='Interests:'))
      interests.add_widget(Label(text='Sports'))
      self.cb1 = CheckBox()
      self.cb1.bind(active=self.on_interest)
      interests.add_widget(self.cb1)

      self.cb2 = CheckBox()
      self.cb2.bind(active=self.on_interest)
      interests.add_widget(Label(text='Music'))
      interests.add_widget(self.cb2)

      self.cb3 = CheckBox()
      self.cb3.bind(active=self.on_interest)
      interests.add_widget(Label(text='Travel'))
      interests.add_widget(self.cb3)

      self.lbl1 = Label(text="Interests selected: ", font_size=32)
      main.add_widget(interests)
      main.add_widget(self.lbl1)

      return main

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

Output

运行此代码时，它将生成如下所示的 GUI −

kivy checkbox