复选框

在 1.4.0 版本加入.

_images/checkbox.png

CheckBox 是一个特定的两态按钮,可以被选中或取消选中。如果 CheckBox 位于一个组中,它就变成了单选按钮。与 ToggleButton 类似,当设置了 CheckBox.group 时,同一时间只能选择一个单选按钮。

示例用法:

from kivy.uix.checkbox import CheckBox

# ...

def on_checkbox_active(checkbox, value):
    if value:
        print('The checkbox', checkbox, 'is active')
    else:
        print('The checkbox', checkbox, 'is inactive')

checkbox = CheckBox()
checkbox.bind(active=on_checkbox_active)
class kivy.uix.checkbox.CheckBox(**kwargs)[源代码]

基类:ToggleButtonBehavior, Widget

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

active

指示开关是处于激活状态还是非激活状态。

active 是一个布尔值,反映并设置底层 state 是 'down'(True)还是 'normal'(False)。它是一个 AliasProperty,接受布尔值,默认值为 False。

在 1.11.0 版本发生变更: 它从BooleanProperty变为了AliasProperty。

background_checkbox_disabled_down

复选框在禁用且激活状态下,用于默认图形表示的背景图像。

在 1.9.0 版本加入.

background_checkbox_disabled_down 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_disabled_on'。

background_checkbox_disabled_normal

复选框在禁用且未激活状态下,用于默认图形表示的背景图像。

在 1.9.0 版本加入.

background_checkbox_disabled_normal 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_disabled_off'。

background_checkbox_down

复选框在激活状态下,用于默认图形表示时的背景图像。

在 1.9.0 版本加入.

background_checkbox_down 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_on'。

background_checkbox_normal

复选框在非激活状态下默认图形表示所使用的背景图像。

在 1.9.0 版本加入.

background_checkbox_normal 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_off'。

background_radio_disabled_down

单选按钮在禁用且激活状态下,用于默认图形表示的背景图像。

在 1.9.0 版本加入.

background_radio_disabled_down 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_radio_disabled_on'。

background_radio_disabled_normal

单选按钮在默认图形表示中,当按钮被禁用且未激活时使用的背景图像。

在 1.9.0 版本加入.

background_radio_disabled_normal 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_radio_disabled_off'。

background_radio_down

单选按钮在激活状态下,用于默认图形表示时的背景图像。

在 1.9.0 版本加入.

background_radio_down 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_radio_on'。

background_radio_normal

单选按钮在非激活状态下,用于默认图形表示时的背景图像。

在 1.9.0 版本加入.

background_radio_normal 是一个 StringProperty,默认值为 'atlas://data/images/defaulttheme/checkbox_radio_off'。

color

颜色用于为复选框和单选按钮的默认图形表示(图像)着色。

颜色格式为(r, g, b, a)。

在 1.10.0 版本加入.

color 是一个 ColorProperty,默认值为 '[1, 1, 1, 1]'。

在 2.0.0 版本发生变更: ListProperty 更改为 ColorProperty