KivyMD——MDButton

1. 简介

MDButton是KivyMD中用于触发操作的按钮控件。它具有许多属性和方法，可以自定义按钮的外观和行为。

2. 基本用法

要创建一个MDButton，您可以使用以下代码：

Python

from kivymd.uix.button import MDButton

button = MDButton(text="Click Me")

此代码将创建一个新的MDButton实例，并将其文本设置为“Click Me”。

您可以将MDButton添加到任何Kivy布局中。以下是如何将其添加到MDBoxLayout中的示例：

Python

from kivymd.app import MDApp
from kivymd.uix.boxlayout import MDBoxLayout
from kivymd.uix.button import MDButton

class MyMDApp(MDApp):

    def build(self):
        layout = MDBoxLayout()
        button = MDButton(text="Click Me")
        layout.add_widget(button)
        return layout

if __name__ == "__main__":
    MyMDApp().run()

3. 属性

MDButton具有许多属性，可用于自定义其外观。以下是一些常用的属性：

• text: 按钮上的文本
• theme_text_color: 文本颜色，可选值为Material Design主题中的颜色名称
• text_color: 文本颜色，可以使用RGBA格式的元组指定
• use_font_smoothing: 是否使用字体平滑，默认值为True
• raised: 是否使用凸起样式，默认值为False
• on_press: 当按钮被按下时触发的回调函数

以下是如何设置一些属性的示例：

Python

button = MDButton(
    text="Custom Button",
    theme_text_color="Custom",
    text_color=(0, 1, 0, 1),
    use_font_smoothing=False,
    raised=True,
)

4. 方法

MDButton还提供了一些方法，可用于控制其行为。以下是一些常用的方法：

• set_text(text): 设置按钮上的文本
• get_text(): 获取按钮上的文本
• set_theme_text_color(color): 设置文本颜色
• set_text_color(color): 设置文本颜色
• press(): 模拟按钮按下

以下是如何使用一些方法的示例：

Python

button.set_text("Press Me!")
text = button.get_text()
print(text)  # 输出：Press Me!

button.set_theme_text_color("Error")
button.set_text_color((1, 0.5, 0, 1))

button.press()  # 模拟按钮按下

5. 事件处理

您可以使用 on_press 属性来处理按钮按下事件。该属性接收一个回调函数，该函数将在按钮按下时被调用。以下是如何处理按钮按下事件的示例：

Python

from kivymd.app import MDApp
from kivymd.uix.boxlayout import MDBoxLayout
from kivymd.uix.button import MDButton

class MyMDApp(MDApp):

    def button_press(self, instance):
        print("Button pressed!")

    def build(self):
        layout = MDBoxLayout()
        button = MDButton(text="Click Me", on_press=self.button_press)
        layout.add_widget(button)
        return layout

if __name__ == "__main__":
    MyMDApp().run()

在上面的示例中，button_press 函数将在按钮按下时被调用。您可以使用此函数执行任何操作，例如更新应用程序界面或触发其他事件。

6. 实例

以下是一些MDButton的使用实例：

• 创建一个带有自定义文本和颜色的按钮

Python

from kivymd.uix.button import MDButton

button = MDButton(
    text="Custom Button",
    theme_text_color="Custom",
    text_color=(0, 1, 0, 1),
    use_font_smoothing=False,
    raised=True,
)

• 创建一个带有图标的按钮

Python

from kivymd.uix.button import MDButton
from kivymd.uix.icon import MDIcon

icon = MDIcon("home")

button = MDButton(
    text="Home",
    theme_text_color="Primary",
    icon=icon,
    left_icon=True,
)