### Toga 库简介 Toga 是一个跨平台的 Python 原生 GUI 工具包，允许开发者编写一次代码并将其部署到多个操作系统上，如 macOS、Windows 和 Linux。它的设计目标是通过 Python 提供统一的 API 接口，同时保留各操作系统的本地化特性[^2]。 以下是关于 Toga 的属性和方法的具体介绍以及示例： --- ### 1. **核心组件** #### (1) `App` 类 - 表示应用程序的核心对象。 - 方法： - `.main_loop()`: 启动应用的主要事件循环。 - `.exit()`: 关闭当前的应用程序实例。 - 属性： - `.name`: 返回应用程序名称。 - `.icon`: 设置或获取应用程序图标。 **示例：** ```python import toga class MyApp(toga.App): def startup(self): self.main_window = toga.MainWindow(title=self.name) self.main_window.content = toga.Box() self.main_window.show() if __name__ == '__main__': app = MyApp('My Application', 'org.example.myapp') app.main_loop() ``` --- #### (2) `MainWindow` 类 - 表示主窗口的对象。 - 方法： - `.show()`: 显示窗口。 - `.close()`: 关闭窗口。 - 属性： - `.title`: 获取或设置窗口标题。 - `.size`: 获取或设置窗口大小。 **示例：** ```python self.main_window.title = "Updated Title" self.main_window.size = (800, 600) ``` --- ### 2. **控件及其常用方法** #### (1) `Button` 控件 - 创建按钮。 - 方法： - `.enable()`: 启用按钮。 - `.disable()`: 禁用按钮。 - 属性： - `.text`: 获取或设置按钮上的文字。 **示例：** ```python button = toga.Button('Click Me', on_press=lambda widget: print("Pressed!")) box = toga.Box(children=[button]) ``` --- #### (2) `TextBox` 控件 - 输入框用于接收用户输入。 - 方法： - `.clear()`: 清除文本框中的内容。 - 属性： - `.value`: 获取或设置文本框的内容。 **示例：** ```python textbox = toga.TextInput(initial='Default Text') print(textbox.value) # 输出默认文本 ``` --- #### (3) `Label` 控件 - 静态标签显示只读文本。 - 属性： - `.text`: 获取或设置标签的文字。 **示例：** ```python label = toga.Label('This is a label.') ``` --- ### 3. **布局管理器** Toga 使用 Flexbox 进行布局管理，默认情况下可以通过调整容器内的子元素来控制 UI 外观。 **示例：水平排列两个按钮** ```python container = toga.Box(style=Pack(direction=ROW)) btn1 = toga.Button('Left Button', style=Pack(flex=1)) btn2 = toga.Button('Right Button', style=Pack(flex=1)) container.add(btn1, btn2) ``` --- ### 4. **事件处理机制** Toga 支持绑定回调函数以响应用户的交互行为。 **示例：点击按钮触发弹窗** ```python def show_popup(widget): dialog = toga.Window(title="Popup", size=(300, 200), position=(100, 100)) dialog.show() popup_button = toga.Button('Show Popup', on_press=show_popup) ``` --- ### 总结 以上介绍了 Toga 中的关键类（如 App 和 MainWindow）、常见控件（如 Button 和 TextBox），以及如何使用它们构建简单的图形界面[^2]。这些基础概念可以帮助快速入门开发基于 Toga 的跨平台桌面应用。