CustomTkinter 用于用 Python 构建现代风格的桌面 GUI 应用,是建立在标准 Tkinter 之上的控件库。
主要能力:提供 CTk、CTkButton、CTkEntry、CTkFrame、CTkTabview 等控件;支持单色与 (light, dark) 元组颜色,应用可随外观模式自动切换配色;支持设置外观模式("dark"、"light"、"system")与默认颜色主题("blue"、"green"、"dark-blue" 或自定义 JSON 路径)。
使用方式:安装命令为 pip install customtkinter。基本结构为导入 customtkinter,创建 CTk() 实例、设置 geometry 与 title、添加控件、调用 mainloop()。官方资料强调:应使用 CTk() 而不是 Tk(),否则主题不生效;只应有一个 CTk 实例且只调用一次 mainloop();子窗口使用 CTkToplevel(master) 且不调用 mainloop;布局沿用标准 Tkinter 的 pack()、grid() 或 place()。也建议用类继承 CTk 组织应用结构。主题与外观设置需在创建 CTk() 之前调用 set_appearance_mode 和 set_default_color_theme。打开子窗口时可检查实例是否存在以避免重复开启,存在则调用 focus()。
适用场景:需要为 Python 程序提供较现代外观的桌面界面,如基础应用、表单、标签页、可滚动框架与对话框等。
限制与未提供信息:资料仅覆盖控件、颜色、主题、窗口与打包等基础用法,未提供具体收费、价格、平台兼容范围或性能数据。更详细的控件 API、窗口、颜色与打包说明见 reference.md,示例见 examples.md。