TkEasyGo 0.1.0

A simple cross-platform GUI generator.

TkEasyGo

TkEasyGo 是一个简单的跨平台 GUI 生成器，旨在帮助开发者快速创建基本的图形用户界面。它基于 tkinter 实现，并提供了一系列基本控件和功能，使用户能够轻松构建简单的应用界面。

文件结构

以下是项目的文件结构及其用途说明：

├── docs
│   └── docs.md                 # 项目的详细文档，包含库的使用说明和开发指南
├── examples
│   ├── Combobox_app.py          # 示例：展示如何使用下拉框控件（Combobox）
│   ├── event_app.py             # 示例：演示如何处理事件
│   ├── label_app.py             # 示例：展示如何使用标签控件（Label）
│   ├── layout_app.py            # 示例：展示如何使用不同的布局管理功能
│   ├── notebook_Slider_app.py   # 示例：展示如何使用选项卡控件（Notebook）和滑块控件（Slider）
│   ├── Progressbar_app.py       # 示例：展示如何使用进度条控件（Progressbar）
│   ├── tabbed_app.py            # 示例：展示如何使用选项卡（Tabbed）控件
│   └── test_window.py           # 示例：展示如何创建和操作基本窗口
├── LICENSE                      # 项目许可证文件，详细信息请参见
├── README.md                    # 项目说明文件
├── setup.py                     # 安装脚本，包含库的依赖和安装设置
├── TkEasyGo
│   ├── core.py                  # 核心实现文件，定义主要的控件和窗口管理功能
│   ├── events.py                # 事件处理功能实现
│   ├── layout.py                # 布局管理功能实现
│   ├── platform.py              # 平台相关的功能实现
│   ├── themes.py                # 主题和样式管理功能实现
│   ├── __init__.py              # 库的初始化文件
│   └── __pycache__              # 编译的 Python 字节码文件
│       ├── core.cpython-310.pyc
│       └── __init__.cpython-310.pyc

目前支持的功能

• 标签 (Label): 显示静态文本。
• 按钮 (Button): 触发事件的按钮。
• 文本框 (Textbox): 用于输入和显示文本。
• 复选框 (Checkbox): 允许用户选择或取消选择一个选项。
• 单选按钮 (Radiobutton): 允许用户在多个选项中选择一个。
• 下拉框 (Combobox): 提供一个下拉列表供用户选择。
• 进度条 (Progressbar): 显示进度的可视化控件。
• 滑块 (Slider): 用于在数值范围内选择值。
• 选项卡 (Notebook): 提供多个标签页以组织内容。
• 帧 (Frame): 用于组织和分组其他控件。

未来计划

• 增强主题支持: 引入更多的主题和样式选项，以提升界面的美观性和用户体验。
• 增加更多控件: 如日历控件、图表控件等，以满足更复杂的应用需求。
• 改进布局管理: 提供更灵活的布局选项，使用户可以更自由地安排控件的位置和大小。
• 提高性能: 优化控件的性能，确保在大型应用中依然流畅。

待办事项

• 用户文档: 完善用户手册和开发文档，以帮助用户更好地使用库。
• 示例应用: 提供更多示例应用和教程，以展示库的不同用法和功能。
• 错误修复: 持续修复已知的 bug 和问题，以提升库的稳定性。
• 社区支持: 建立社区支持渠道，收集用户反馈并及时响应。

TkEasyGo 使用教程

TkEasyGo 是一个简化的跨平台 GUI 生成器，基于 tkinter 实现，旨在帮助开发者快速创建图形用户界面。本文将介绍如何安装和使用 TkEasyGo，展示一些常见的用法示例，并提供一些技巧和注意事项。

安装

要安装 TkEasyGo，可以使用 pip 从 PyPI 安装：

pip install TkEasyGo

快速入门

创建一个基本的窗口

下面的示例展示了如何创建一个简单的窗口，并添加一些基本控件：

from TkEasyGo.core import SimpleWindow, SimpleVariable

def basic_app():
    # 创建窗口
    window = SimpleWindow(title="Basic TkEasyGo App", width=300, height=200)
    
    # 添加标签
    window.add_label("Welcome to TkEasyGo!", row=0, column=0, columnspan=2)
    
    # 添加文本框
    textbox = window.add_textbox("Type here...", row=1, column=0, columnspan=2)
    
    # 添加按钮
    button = window.add_button("Submit", lambda: print("Submit clicked"), row=2, column=0, columnspan=2)
    
    # 添加复选框
    checkbox_var = SimpleVariable()
    window.add_checkbox("Check me", checkbox_var, row=3, column=0)
    
    # 运行窗口
    window.run()

if __name__ == "__main__":
    basic_app()

控件介绍

标签 (Label)

用于显示静态文本。可以通过 add_label 方法添加。

window.add_label("This is a label", row=0, column=0)

按钮 (Button)

用于触发事件。可以通过 add_button 方法添加。

window.add_button("Click Me", lambda: print("Button clicked"), row=1, column=0)

文本框 (Textbox)

用于输入和显示文本。可以通过 add_textbox 方法添加。

textbox = window.add_textbox("Default text", row=2, column=0)

复选框 (Checkbox)

允许用户选择或取消选择一个选项。可以通过 add_checkbox 方法添加。

checkbox_var = SimpleVariable()
window.add_checkbox("Check me", checkbox_var, row=3, column=0)

单选按钮 (Radiobutton)

允许用户在多个选项中选择一个。可以通过 add_radiobutton 方法添加。

radiobutton_var = SimpleVariable("1")
window.add_radiobutton("Option 1", "1", radiobutton_var, row=4, column=0)

下拉框 (Combobox)

提供一个下拉列表供用户选择。可以通过 add_combobox 方法添加。

combobox = window.add_combobox(["Option 1", "Option 2", "Option 3"], row=5, column=0)

进度条 (Progressbar)

显示进度的可视化控件。可以通过 add_progressbar 方法添加。

progressbar = window.add_progressbar(value=50, row=6, column=0, columnspan=2)

滑块 (Slider)

用于在数值范围内选择值。可以通过 add_slider 方法添加。

slider = window.add_slider(value=50, row=7, column=0, columnspan=2)

选项卡 (Notebook)

提供多个标签页以组织内容。可以通过 add_notebook 方法添加。

def tab1_content(window, frame):
    window.add_label("This is Tab 1", row=0, column=0, frame=frame)
    window.add_button("Button in Tab 1", lambda: print("Tab 1 Button clicked"), row=1, column=0, frame=frame)

def tab2_content(window, frame):
    window.add_label("This is Tab 2", row=0, column=0, frame=frame)
    window.add_button("Button in Tab 2", lambda: print("Tab 2 Button clicked"), row=1, column=0, frame=frame)

window.add_notebook({"Tab 1": tab1_content, "Tab 2": tab2_content}, row=8, column=0, columnspan=2)

事件绑定

可以通过 bind_event 方法为控件绑定事件：

window.bind_event('textbox', '<KeyRelease>', lambda event: print(f"Text changed to: {textbox.get()}"))
window.bind_event('button', '<Button-1>', lambda event: print("

Button clicked"))

窗口操作

设置窗口的最小化、最大化和恢复功能

SimpleWindow 提供了窗口操作的方法，包括最小化、最大化和恢复：

• 最大化: 使用 maximize() 方法将窗口切换到全屏模式。
• 最小化: 使用 minimize() 方法将窗口最小化到任务栏。
• 恢复: 使用 restore() 方法将窗口恢复到原始大小。

示例代码如下：

def window_operations_app():
    window = SimpleWindow(title="Window Operations App", width=400, height=300)
    
    # 添加操作按钮
    window.add_button("Maximize", window.maximize, row=0, column=0)
    window.add_button("Minimize", window.minimize, row=1, column=0)
    window.add_button("Restore", window.restore, row=2, column=0)
    
    # 运行窗口
    window.run()

if __name__ == "__main__":
    window_operations_app()

常见问题

如何调整控件的样式？

你可以在 SimpleWindow 的 configure_styles 方法中配置控件的样式。例如：

window.configure_styles('TButton', padding=6, relief="flat", background="#4CAF50", font=("Arial", 12))

如何贡献代码？

如果你希望为 TkEasyGo 做出贡献，可以通过 GitHub 提交 Pull Request，或者报告问题和建议。我们欢迎任何形式的贡献。

联系我们

• 电子邮件: [e-mail]
• GitHub: https://github.com/TkEasyGo/TkEasyGo

许可证

本项目使用 MIT 许可证，详细信息请参见 LICENSE 文件。