An auxiliary module of the tkinder module
Project description
🚀tkintertools🚀
The tkintertools
module is an auxiliary module of the tkinter
module
tkintertools
模块是 tkinter
模块的辅助模块
🚀Installation/模块安装
👉Stable version/稳定版本
- Version/版本 : 2.6.0
- Release Date/发布日期 : 2023/03/28
pip install tkintertools==2.6.0
👉Development version/开发版本
- Version/版本 : 2.6.0
- Release Date/发布日期 : 2023/03/20
pip install tkintertools-dev==2.6.0
🚀Description/模块说明
tkintertools
是一个完全没有使用任何第三方模块和库的Python界面开发模块,同时,它也没有任何依赖包,它的功能完全由内置模块和函数实现。
tkintertools
是一款基于 tkinter
模块的二次开发的界面编程模块,它和 tkinter
最大的不同在于,它的控件并非真实的控件,而是在 tkinter
模块中 Canvas
对象中绘制而成的,这就赋予了 tkintertools
控件一些特性,列举如下:
- 控件背景可以是透明的👍
- 控件的样式可以是自定义的👍
- 控件的创建速度是远大于
tkinter
的控件的👍
开发 tkintertools
模块选用的 Python 版本为 3.10,在这个及以上版本的 Python 拥有很好的类型提示语法,能为用户提供最好的语法提示。这里没有选择用 .pyi 存根文件的方式来实现类型提示的功能,主要原因是 .pyi 文件不方便和模块真正的文件进行同步修改,而且既然这个类型提示的功能在 Python3.6(Python3.10 的类型提示语法得到进一步强化) 以上在源代码中实现,那何必再用存根文件呢?
使用 Python3.10 强化了的类型提示语法也意味着用户使用的 Python 版本也必须至少为 3.10,为了弥补兼容性,后续会推出兼容版的 tkintertools。目前需要兼容的用户,可以在源代码中自行修改,需要修改的语法如下:
3.9 及更低版本 : 类型提示语法中的 “|”,isinstance 函数中的 “|”
3.7 及更低版本 : 赋值运算符的海象运算符 “:=”
3.6 及更低版本 : fractions
模块 Fraction
类的 limit_denominator
方法(建议升级Python版本)
3.5 及更低版本 : 全部的类型提示语法(建议升级Python版本)
🚀Provides/模块功能
Here, only the more distinctive features will be listed
这里只会列举出比较具有特色的功能
⭐Customizable widgets/可自定义的控件
⭐Automatically control size/自动控制大小
⭐Easily move widgets/轻松移动控件
⭐Gradient colors/渐变色
⭐Automatically adapt to DPI/自动适应DPI
⭐Scalable Picture/可缩放图片
⭐Detailed type tips/详细的类型提示
🚀Contents/模块内容
Each non internal class and function in the module will be described in detail here
这里会详细说明模块中的每个非内部类和函数
⭐Container Widget/容器控件
-
Tk
: 窗口类继承于
tkinter.Tk
,在继承了tkinter
模块内Tk
的基础上,又加入了对tkintertools
模块中的Canvas
对象的支持,并加入了检测窗口大小是否缩放的机制,以使得其子Canvas
均能正确地进行缩放 -
Toplevel
: 顶级窗口类继承于
tkinter.Toplevel
和Tk
,加入了对tkintertools
模块中的Canvas
对象的支持,其余均与Tk
一样 -
Canvas
: 画布类继承于
tkinter.Canvas
,加入了对画布虚拟控件的支持,同时是各类响应事件、缩放控制的管理者,也对tkinter.Canvas
的实例方法有一定的兼容性
⭐Virtual Canvas Widget/虚拟画布控件
-
Label
: 标签控件标签控件的功能和
tkinter.Label
的功能类似,但更加的多元化
下面是Label
控件的外观:
""" Label Test """ import tkintertools as tkt root = tkt.Tk('LabelTest', 1000, 400) canvas = tkt.Canvas(root, 1000, 400) canvas.place(x=0, y=0) def colorful(x: int, y: int, width: int, height: int) -> None: """ Gradient colors """ for i in range(width): color = tkt.color(('#FF0000', '#0000FF'), i/width) canvas.create_line(x+i, y, x+i, y+height, fill=color) colorful(510, 175, 480, 150) tkt.Label(canvas, 50, 50, 400, 100, 0, 'NormalLabel\nHere is the text') tkt.Label(canvas, 50, 200, 400, 100, 20, 'RoundCornerLabel') tkt.Label(canvas, 550, 50, 400, 100, 0, 'DisableLabel').set_live(False) tkt.Label(canvas, 550, 200, 400, 100, 20, 'TransparentLabel', color_fill=tkt.COLOR_NONE) tkt.SetProcessDpiAwareness() root.mainloop()
-
Button
: 按钮控件按钮控件相较于
tkinter.Button
,其自由度更高,tkinter.Button
只有在按下的时候才能触发绑定的关联事件,而Button
却可以在鼠标移至按钮上方时、鼠标按下时、鼠标松开时都可以绑定关联事件
下面是Button
控件的外观:
""" Button Test """ import tkintertools as tkt root = tkt.Tk('ButtonTest', 500, 500) canvas = tkt.Canvas(root, 500, 500) canvas.place(x=0, y=0) def colorful(x: int, y: int, width: int, height: int) -> None: """ Gradient colors """ for i in range(width): color = tkt.color(('#FF0000', '#0000FF'), i/width) canvas.create_line(x+i, y, x+i, y+height, fill=color) colorful(50, 280, 400, 100) tkt.Button(canvas, 150, 135, 200, 50, 0, 'NormalButton') tkt.Button(canvas, 100, 195, 300, 50, 10, 'RoundCornerButton') tkt.Button(canvas, 150, 255, 200, 50, 0, 'DisableButton').set_live(False) tkt.Button(canvas, 100, 315, 300, 50, 10, 'TransparentButton', color_fill=tkt.COLOR_NONE) tkt.SetProcessDpiAwareness() root.mainloop()
-
CheckButton
: 复选框控件
文档正在制造中...
-
Entry
: 输入框控件输入框控件可以轻松地设置输入的文本位置(靠左、居中和靠右),同时,它可以在鼠标移至输入框上方、鼠标未在输入框上方两种状态显示不同的默认文本
下面是Entry
控件的外观:
""" Entry Test """ import tkintertools as tkt root = tkt.Tk('EntryTest', 500, 400) canvas = tkt.Canvas(root, 500, 400) canvas.place(x=0, y=0) def colorful(x: int, y: int, width: int, height: int) -> None: """ Gradient colors """ for i in range(width): color = tkt.color(('#FF0000', '#0000FF'), i/width) canvas.create_line(x+i, y, x+i, y+height, fill=color) colorful(50, 193, 400, 100) tkt.Entry(canvas, 20, 20, 200, 30, 0, ('LeftEntry', 'Enter')) tkt.Entry(canvas, 20, 55, 200, 30, 0, ('CenterEntry', 'Enter'), justify='center') tkt.Entry(canvas, 20, 90, 200, 30, 0, ('RightEntry', 'Enter'), justify='right') tkt.Entry(canvas, 270, 20, 200, 30, 8, 'LeftEntry') tkt.Entry(canvas, 270, 55, 200, 30, 8, 'CenterEntry', justify='center') tkt.Entry(canvas, 270, 90, 200, 30, 8, 'RightEntry', justify='right') tkt.Entry(canvas, 100, 150, 300, 35, 0, ('PasswordEntry', 'Click To Enter'), justify='center', show='•') tkt.Entry(canvas, 100, 200, 300, 35, 0, 'DisableEntry', justify='center').set_live(False) tkt.Entry(canvas, 100, 250, 300, 35, 0, 'TransparentEntry', justify='center', color_fill=tkt.COLOR_NONE) tkt.SetProcessDpiAwareness() root.mainloop()
-
Text
: 文本框控件文本框类似于输入框,这里就不再赘述
下面是Text
控件的外观:
""" Text Test """ import tkintertools as tkt root = tkt.Tk('TextTest', 1000, 400) canvas = tkt.Canvas(root, 1000, 400) canvas.place(x=0, y=0) def colorful(x: int, y: int, width: int, height: int) -> None: """ Gradient colors """ for i in range(width): color = tkt.color(('#FF0000', '#0000FF'), i/width) canvas.create_line(x+i, y, x+i, y+height, fill=color) colorful(510, 175, 480, 150) tkt.Text(canvas, 50, 50, 400, 100, 0, ('NormalText(Left)', 'Click To Enter')) tkt.Text(canvas, 50, 200, 400, 100, 20, 'RoundCornerText(Center)', justify='center') tkt.Text(canvas, 550, 50, 400, 100, 0, 'DisableText').set_live(False) tkt.Text(canvas, 550, 200, 400, 100, 20, 'TransparentText(Right)', justify='right', color_fill=tkt.COLOR_NONE) tkt.SetProcessDpiAwareness() root.mainloop()
-
Progressbar
: 进度条控件进度条控件相比
tkinter.ttk.Progressbar
,外观上的自由度较大
下面是Progressbar
控件的外观:
""" Progressbar Test """ import tkintertools as tkt root = tkt.Tk('ProgressbarTest', 500, 500) canvas = tkt.Canvas(root, 500, 500) canvas.place(x=0, y=0) def colorful(x: int, y: int, width: int, height: int) -> None: """ Gradient colors """ for i in range(width): color = tkt.color(('#FF0000', '#0000FF'), i/width) canvas.create_line(x+i, y, x+i, y+height, fill=color) colorful(30, 290, 440, 50) tkt.Progressbar(canvas, 50, 50, 400, 30) tkt.Progressbar(canvas, 50, 100, 400, 30).load(.6667) tkt.Progressbar(canvas, 50, 150, 400, 30, 5).load(1) (_ := tkt.Progressbar(canvas, 50, 200, 400, 30)).load(0.3333) _.set_live(False) tkt.Progressbar(canvas, 50, 250, 400, 30, color_bar=( 'lightyellow', 'skyblue')).load(.5) tkt.Progressbar(canvas, 50, 300, 400, 30, color_bar=('', 'orange')).load(.1667) progressbar = tkt.Progressbar(canvas, 50, 375, 400, 30) progressbar_2 = tkt.Progressbar(canvas, 50, 425, 400, 30) def load(total: int, count: int = 0) -> None: """ load progressbar """ progressbar.load(count/total) progressbar_2.load(1-count/total) if count < total: root.after(3, load, total, count+1) load(10000) tkt.SetProcessDpiAwareness() root.mainloop()
⭐Tool Class/工具类
-
PhotoImage
: 图片类PhotoImage
类继承于tkinter.PhotoImage
,它是在tkinter.PhotoImage
的基础上做功能的强化,对 gif 动图有很好的支持,仅需极少量代码即可实现动图的显示,还可以设置动图显示的速度,此外,对 png 类型的图片的支持也有强化,可以在不依赖任何第三方模块或者库的情况下,对图片进行缩放 -
Singleton
: 单例模式类单例模式,不用介绍了吧?通过继承它来使用
⭐Tool Function/工具函数
-
move
: 移动函数移动函数可以轻松地按一定的规律、移动速度、移动时间去移动
tkintertools
模块内的所有对象,同时兼容了tkinter
内的对象,即tkinter
中的对象也可以很方便地移动,甚至它还可以移动窗口的位置!
""" Move Test """ import tkintertools as tkt root = tkt.Tk('MoveTest', 500, 500) canvas = tkt.Canvas(root, 500, 500) canvas.place(x=0, y=0) rect = canvas.create_rectangle(50, 350, 150, 450) def move_window(switch: list[bool] = [True]) -> None: tkt.move(root, None, 1000 if switch[0] else -1000, 0, 800, 'flat') switch[0] = not switch[0] def move_button(switch: list[bool] = [True]) -> None: tkt.move(canvas, button, 200 if switch[0] else -200, 0, 500, 'rebound') switch[0] = not switch[0] def move_rect(switch: list[bool] = [True]) -> None: tkt.move(canvas, rect, 200 if switch[0] else -200, 0, 500, 'smooth') switch[0] = not switch[0] tkt.Button(canvas, 50, 50, 200, 40, 10, 'MoveWindow', command=move_window) tkt.Button(canvas, 50, 100, 200, 40, 10, 'MoveRect', command=move_rect) button = tkt.Button(canvas, 50, 150, 200, 40, 10, 'MoveButton', command=move_button) tkt.SetProcessDpiAwareness() root.mainloop()
-
text
: 文本函数可以快速并方便地得到一个参数长度的字符串,且字符串的内容可以指定位置
如:得到一个20长度的字符串“tkintertools”`left` : "tkintertools " `center` : " tkintertools " `right` : " tkintertools"
-
color
: 颜色函数颜色函数可以轻松求出一个颜色到另外一个颜色的过渡颜色,因此可以轻松得到渐变色的效果,同时,改变传入的参数还可以得到传入颜色的对比色
第二张图是 test.py 在图像测试中绘制的图案
""" Color Test """ import tkintertools as tkt root = tkt.Tk('ColorTest', 500, 500) canvas = tkt.Canvas(root, 500, 500) canvas.place(x=0, y=0) def colorful(x: int, y: int, width: int, height: int) -> None: """ Gradient colors """ for i in range(width): color = tkt.color(('#FF0000', '#00FF00'), i/width) color_2 = tkt.color(('#FFFFFF', '#000000'), i/width) canvas.create_line(x+i, y, x+i, y+height, fill=color) canvas.create_oval(250-i/3, 300-i/3, 250+i/3, 300 + i/3, outline=color_2, width=2) colorful(50, 50, 400, 100) tkt.SetProcessDpiAwareness() root.mainloop()
-
askfont
: 字体选择对话框详细文档正在生成中...
-
SetProcessDpiAwareness
: DPI 级别设置函数这个函数实际上只是对函数
ctypes.OleDLL('shcore').SetProcessDpiAwareness
的一个简单包装,其值可为 0、1 和 2,分别代表程序 DPI 的不同级别,那么缩放效果也就不同,tkintertools
选择的值是 1,但程序默认值实际为 0
下面是执行了这个函数的效果
下面是未执行这个函数的效果
从上面的两张图中可以很明显的看出第一张很模糊,第二张很清晰,这就是 DPI 级别不同的原因,不过这一点在平面缩放比不是 100% 的时候才会出现
大家对上面的图肯定很熟悉,这不就是 IDLE 吗!?对,这个的问题的解决办法也是来自于 IDLE 的源代码 [pyshell.py line 18~20]
注意:该函数在程序的不同位置执行的效果不一样!一般用在mainloop
之前。
🚀More/更多
GitHub(Mirror/镜像):
https://github.com/XiaoKang2022-CSDN/tkintertools
Column/专栏:
https://blog.csdn.net/weixin_62651706/category_11600888.html
Tutorials/教程:
https://xiaokang2022.blog.csdn.net/article/details/127374661
还有更多内容请在源码中探索!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tkintertools-2.6.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 282cb5ed27e0cbecfd71bbacd8c65f6f7288226a93e6dc529bc90280060cb190 |
|
MD5 | 0c94ad776ca0ce1847f88ade7aff1323 |
|
BLAKE2b-256 | 5f47fd233088dd3cfaa98e58fb61187ac787c9617514f525b50facf85cce261b |