Kivy - 按钮

创建于 2024-12-03 / 27
字体: [默认] [大] [更大]

按钮是任何 GUI 库(包括 Kivy)中最重要的元素之一。按钮对象由标签组成,通常用于指示其用途(例如带有"开始"标题的标签,或带有"文件夹"图标以指示"打开文件操作"),并且能够响应某些事件,例如触摸或鼠标单击。

Button 类在"kivy.uix.button"模块中定义。Button 对象的外观可以通过在 Label 类中定义的同一组属性来配置。 Button 类也继承自 ButtonBehavior mixin。

Button 对象使用以下语法实例化 −

b1 = Button(**kwargs)

要配置按钮,您可以将其属性指定为构造函数的关键字参数 −

  • background_color − 按钮的背景颜色是 ColorProperty,格式为 (r, g, b, a),默认值为 [1,1,1,1]。

  • background_disabled_down −按钮的背景图像是一个 StringProperty,即包含图像文件路径的字符串,用于禁用和按下按钮时的默认图形表示。

  • background_disabled_normal − 按钮的背景图像也是一个图像路径,用于禁用且未按下按钮时的默认图形表示。

  • background_down − 按下按钮时用作默认图形表示的按钮背景图像。

  • background_normal − 未按下按钮时用作默认图形表示的按钮背景图像。

除上述内容外,Button 还从 Label 类继承属性,其中一些属性如下 −

  • bold − 表示使用字体的粗体版本。它是一个 BooleanProperty,默认为 False。

  • underline − 为文本添加下划线。此功能需要 SDL2 文本提供程序,它是一个 BooleanProperty,默认为 False。

  • strikethrough − 为文本添加删除线。此功能需要 SDL2 文本提供程序。它是一个 BooleanProperty,默认为 False。

  • text − 标签的文本。例如 −

widget = Button(text='Hello world')

text 是一个 StringProperty,默认为 ''。

  • color − 文本颜色,格式为 (r, g, b, a)。它是一个 ColorProperty,默认为 [1, 1, 1, 1]。

  • font_size − 文本的字体大小,以像素为单位。"font_size"是一个 NumericProperty,默认为 15sp。

Button 类还从 ButtonBehavior 类继承了 state 属性。

  • state −按钮的状态必须是"正常"或"按下"之一。仅当按钮当前被触摸/单击时,状态才为"按下",否则为"正常"。它是一个 OptionProperty,默认为"正常"。

Button 类还从 Widget 类继承了 disabled、height、widthpos 等属性。

如果您想在 Kivy 应用程序窗口上显示按钮,则可以通过在 build() 方法中声明按钮对象来实现,或者使用"kv"语言脚本。

使用 build() 方法显示按钮

让我们使用上面解释的一些属性配置按钮 −

示例

from kivy.app import App
from kivy.uix.button import Button
from kivy.config import Config

# Configuration
Config.set('graphics', 'width', '720')
Config.set('graphics', 'height', '300')
Config.set('graphics', 'resizable', '1')

class HelloApp(App):
   def build(self):
      b1 = Button(text = "A Kivy Button",
         font_size=50,
         color = [0.8, 0.2, 0.3, 1])
      return b1

app = HelloApp()
app.run()

输出

运行此代码,您将获得以下输出

Kivy Button1

使用"kv"语言方法显示按钮

示例

将以下脚本保存为"hello.kv"。

Button:
   text: 'A Kivy Button'
   font_size: '20pt'
   underline: True
   background_color: [1,0,0,1]
   size_hint: (.25, .25)
   pos_hint: {'center_x':.5, 'center_y':.5}

输出

注释掉 App 类中的 build() 方法并再次运行应用程序。您将获得以下窗口作为 输出

kivy button2

0 人点赞过