KIVY Button¶

Button --- Kivy 2.3.0 documentation

Button

Jump to API


Module: kivy.uix.button

Added in 1.0.0

The Button is a Label with associated actions that are triggered when the button is pressed (or released after a click/touch). To configure the button, the same properties (padding, font_size, etc) and sizing system are used as for the Label class:

按钮(Button)是一个带有相关动作的标签(Label),这些动作在按钮被按下(或点击/触摸后释放)时触发。为了配置按钮,我们使用了与标签(Label)类相同的属性(如内边距padding、字体大小font_size等)和尺寸系统。

python 复制代码
button = Button(text='Hello world', font_size=14)

To attach a callback when the button is pressed (clicked/touched), use bind:

当按钮被按下(点击/触摸)时,要附加一个回调函数,可以使用bind方法。

python 复制代码
def callback(instance):
    print('The button <%s> is being pressed' % instance.text)

btn1 = Button(text='Hello world 1')
btn1.bind(on_press=callback)
btn2 = Button(text='Hello world 2')
btn2.bind(on_press=callback)

If you want to be notified every time the button state changes, you can bind to the Button.state property:

如果你想要在每次按钮状态发生变化时都收到通知,你可以将事件绑定到Button.state属性上:

python 复制代码
def callback(instance, value):
    print('My button <%s> state is <%s>' % (instance, value))
btn1 = Button(text='Hello world 1')
btn1.bind(state=callback)

Kv Example:

python 复制代码
Button:
    text: 'press me'
    on_press: print("ouch! More gently please")
    on_release: print("ahhh")
    on_state:
        print("my current state is {}".format(self.state))

APIHide Description ⇑


class kivy.uix.button.Button(**kwargs )

Bases: kivy.uix.behaviors.button.ButtonBehavior, kivy.uix.label.Label

Button class, see module documentation for more information.

Changed in version 1.8.0: The behavior / logic of the button has been moved to ButtonBehaviors.

background_color

Background color, in the format (r, g, b, a). 背景颜色,格式为(r, g, b, a)。

This acts as a multiplier to the texture color. The default texture is grey, so just setting the background color will give a darker result. To set a plain color, set the background_normal to ''.

它作为纹理颜色的一个乘数因子。默认纹理是灰色的,所以仅仅设置背景颜色会得到一个更暗的结果。要设置纯色,请将background_normal属性设置为空字符串('')。

New in version 1.0.8. 此功能在版本1.0.8中新增。

The background_color is a ColorProperty and defaults to [1, 1, 1, 1].
background_color是一个ColorProperty,其默认值为[1, 1, 1, 1](即白色,完全不透明)。

Changed in version 2.0.0: Changed from ListProperty to ColorProperty.

在版本2.0.0中更改:从ListProperty更改为ColorProperty。

background_disabled_down

Background image of the button used for the default graphical representation when the button is disabled and pressed.

New in version 1.8.0.

background_disabled_down is a StringProperty and defaults to 'atlas://data/images/defaulttheme/button_disabled_pressed'.

background_disabled_normal

Background image of the button used for the default graphical representation when the button is disabled and not pressed.

按钮的背景图像,用于在按钮被禁用且被按下时的默认图形表示。

New in version 1.8.0. 此功能在版本1.8.0中新增。

background_disabled_normal is a StringProperty and defaults to 'atlas://data/images/defaulttheme/button_disabled'.

background_down

Background image of the button used for the default graphical representation when the button is pressed.

按钮的背景图像,用于按钮被按下时的默认图形表示。

New in version 1.0.4. 此功能在版本1.0.4中新增。

background_down is a StringProperty and defaults to 'atlas://data/images/defaulttheme/button_pressed'.
background_disabled_down是一个StringProperty,其默认值为'atlas://data/images/defaulttheme/button_disabled_pressed'

background_normal

Background image of the button used for the default graphical representation when the button is not pressed.

按钮的背景图像,用于按钮未被按下时的默认图形表示。

New in version 1.0.4. 此功能在版本1.0.4中新增。

background_normal is a StringProperty and defaults to 'atlas://data/images/defaulttheme/button'.
background_normal是一个StringProperty,其默认值为 'atlas://data/images/defaulttheme/button'

border

Border used for BorderImage graphics instruction. Used with background_normal and background_down. Can be used for custom backgrounds.

边框,用于BorderImage图形指令。与background_normalbackground_down一起使用。可用于自定义背景。

It must be a list of four values: (bottom, right, top, left). Read the BorderImage instruction for more information about how to use it.

它必须是一个包含四个值的列表:(底部, 右侧, 顶部, 左侧)。要获取更多关于如何使用它的信息,请阅读BorderImage指令的说明。

border is a ListProperty and defaults to (16, 16, 16, 16)
border是一个ListProperty,其默认值为(16, 16, 16, 16)。

相关推荐
nightunderblackcat6 分钟前
新手向:使用Python将多种图像格式统一转换为JPG
开发语言·python
engchina31 分钟前
Python PDF处理库深度对比:PyMuPDF、pypdfium2、pdfplumber、pdfminer的关系与区别
开发语言·python·pdf
Lo-Y-eH38 分钟前
Openpyxl:Python操作Excel的利器
python·excel
DAWN_T1743 分钟前
Transforms
pytorch·python·机器学习·jupyter·pycharm
一百天成为python专家1 小时前
python库之jieba 库
开发语言·人工智能·python·深度学习·机器学习·pycharm·python3.11
27669582922 小时前
tiktok 弹幕 逆向分析
java·python·tiktok·tiktok弹幕·tiktok弹幕逆向分析·a-bogus·x-gnarly
cylat2 小时前
Day59 经典时序预测模型3
人工智能·python·深度学习·神经网络
嘉恩督2 小时前
视频人脸处理——人脸面部动作提取
python·音视频
WJ.Polar2 小时前
Python数据容器-集合set
开发语言·python
smppbzyc2 小时前
2025年亚太杯(中文赛项)数学建模B题【疾病的预测与大数据分析】原创论文讲解(含完整python代码)
python·数学建模·数据分析·数学建模竞赛·亚太杯数学建模·亚太杯