【亲测免费】 CustomTkinter 开源项目安装及使用指南

目录结构及介绍

在下载或克隆 CustomTkinter 仓库 (https://github.com/TomSchimansky/CustomTkinter.git) 后, 其主要目录结构及内容如下:

• examples: 此目录包含多个示例脚本, 展示如何使用 CustomTkinter 创建各种 GUI 界面. 这是学习和理解库功能的好起点.

• documentation_images: 包含用于文档和教程中的图像. 这些通常是界面截图或者说明特定元素的图片.

• customtkinter: 主要包含 CustomTkinter 库的所有源代码. 这里有所有自定义小部件的实现以及主题设置等功能.

• test: 测试目录包括了单元测试和集成测试文件, 以确保库的功能正确性和稳定性.

除了这些目录外, 你还会发现一些重要的文件:

• .gitignore: 忽略不需要提交到版本控制系统如 .cache, .idea 文件夹的列表.

• CHANGELOG.md: 记录每次发布的主要更改点.

• README.md: 提供关于项目的简短描述, 安装方法以及用法等基本信息.

• pyproject.toml: 托管构建系统和依赖管理元数据.

• requirements.txt: 列出了运行项目所需的第三方包及其版本.

• LICENSE: 项目的许可条款.

启动文件介绍

CustomTkinter 没有一个特定的“主”或 “启动”文件，因为它的设计是作为其他项目的一部分使用的一个库. 在一个典型的使用场景中, 用户会在自己的程序中通过导入以下方式来“启动” CustomTkinter :

import customtkinter

customtkinter.set_appearance_mode("System")
customtkinter.set_default_color_theme("blue")

app = customtkinter.CTk()
app.geometry("400x240")

def button_function():
    print("button pressed")

button = customtkinter.CTkButton(master=app, text="CTkButton", command=button_function)
button.place(relx=0.5, rely=0.5, anchor=customtkinter.CENTER)

app.mainloop()

上述代码创建了一个简单的窗口, 并且这个窗口中的按钮当被点击时会打印出 "button pressed" 的字符串. 要运行该代码, 只需将其保存在一个 .py 文件中并执行即可.

此外, examples 目录下的脚本也都是启动脚本的例子, 每个脚本展示了一种使用 CustomTkinter 的方式. 若要查看某个具体的例子, 将其从该目录运行即可.

配置文件介绍

CustomTkinter 不拥有传统意义上的配置文件，它提供的是函数接口，用于改变外观模式和默认的主题颜色. 这样做的好处在于可以灵活地在运行期间修改主题和样式。

• set_appearance_mode: 设置库的整体外观模式 (光明模式或黑暗模式). 默认情况下, 它将检测系统的外观模式并在运行时自动调整.

  customtkinter.set_appearance_mode("Dark")
  

• set_default_color_theme: 设置整个应用的默认颜色主题. 支持三种预设的主题 ("blue", "green", 和 "dark-blue").

  customtkinter.set_default_color_theme("green")
  

这些设置可以在应用启动时进行初始化设定, 或者在运行过程中动态改变. 更多高级定制, 如指定特定的颜色值或形状参数, 是在创建各组件实例时完成的. 这样的设计使每个元素具有高度的灵活性, 同时保持统一性. 您可以通过查阅 CustomTkinter 的官方文档获取更多详细信息.