在本文中，将介绍 Tkinter Progressbar 进度条小部件。Progressbar 进度条小部件向用户提供长时间运行任务时的进度反馈。
要创建 Progressbar 进度条小部件，请使用以下构造函数：
ttk.Progressbar(container, orient, length, mode)
主要参数如下：
参数
含义
length
进度条的长度，默认是100像素
mode
进度条模式 determinate(默认) 或 indeterminate
maximum
进度条的最大值，默认是100像素
name
进度条的名称，供程序参考引用
orient
进度条的方向，HORIZONTAL(默认) 或 VERTICAL
value
进度条的当前值
variable
记录进度条当前进度值
进度条模式determinate 模式：
进度条会从起点延伸至终点，当知道任务所需时间时，可以使用此模式，这是默认确定模式。
import tkinter as tkfrom tkinter import ttkimport timeroot = tk.Tk()root.geometry('600x400+200+200')root.title('Progressbar 进度条演示')pb = ttk.Progressbar(root, length=280)pb.pack(expand=True)frame=ttk.Frame(root)start_button = ttk.Button(root, text='开始', command=pb.start)start_button.pack(side=tk.LEFT, expand=True)stop_button = ttk.Button(root, text='结束', command=pb.stop)stop_button.pack(side=tk.LEFT, expand=True)frame.pack(fill=tk.X, expand=True)root.mainloop()
indeterminate 模式：
一段进度条会在起点和终点间来回移动，当不知道任务所需时间时，可以使用此不确定模式。
import tkinter as tkfrom tkinter import ttkroot = tk.Tk()root.geometry('600x400+200+200')root.title('Progressbar 进度条演示')pb = ttk.Progressbar(root, orient='horizontal', mode='indeterminate', length=280)pb.pack(expand=True)frame=ttk.Frame(root)start_button = ttk.Button(root, text='开始', command=pb.start)start_button.pack(side=tk.LEFT, expand=True)stop_button = ttk.Button(root, text='结束', command=pb.stop)stop_button.pack(side=tk.LEFT, expand=True)frame.pack(fill=tk.X, expand=True)root.mainloop()
进度条的值可以使用参数 variable 结合 set() 方法，或者使用参数 value 设置进度条的值。使用 cget() 方法获取进度条的值。
import tkinter as tkfrom tkinter import ttkimport timeroot = tk.Tk()root.geometry('600x400+200+200')root.title('Progressbar 进度条演示')var=tk.IntVar()def start1(): for i in range(1, 101): var.set(i) label1['text']=str(pb1.cget('value')),'%' root.update() # 刷新窗口 time.sleep(0.05)def start2(): for j in range(100): pb2['value'] = j + 1 label2['text']=str(pb2.cget('value')),'%' root.update() # 刷新窗口 time.sleep(0.05)pb1 = ttk.Progressbar(root, orient='horizontal', length=280, variable=var)pb1.pack(expand=True)label1 = tk.Label(root,text='0%')label1.pack()pb2 = ttk.Progressbar(root, orient='horizontal', length=280)pb2.pack(expand=True)label2 = tk.Label(root,text='0%')label2.pack()frame=ttk.Frame(root)start_button = ttk.Button(root, text='开始1', command=start1)start_button.pack(side=tk.LEFT, expand=True)stop_button = ttk.Button(root, text='开始2', command=start2)stop_button.pack(side=tk.LEFT, expand=True)frame.pack(fill=tk.X, expand=True)root.mainloop()
进度条的样式利用 Ttk 主题小部件的特性，自定义进度条的样式。
import tkinter as tkfrom tkinter import ttkimport timeroot = tk.Tk()root.geometry('600x400+200+200')root.title('Progressbar 进度条演示')var=tk.IntVar()style = ttk.Style()style.theme_use("clam")style.configure("design.Horizontal.TProgressbar", background="lightblue", troughcolor="lightgray", bordercolor="darkblue", lightcolor="lightblue", darkcolor="darkblue")def start(): pb2.start() for i in range(100): var.set(i) label1['text']=str(pb1.cget('value')) + '%' root.update() # 刷新窗口 time.sleep(0.05)pb1 = ttk.Progressbar(root, orient='horizontal', length=280, variable=var, style='design.Horizontal.TProgressbar')pb1.pack(expand=True)label1 = tk.Label(root,text='0%')label1.pack()pb2 = ttk.Progressbar(root, orient='horizontal', mode='indeterminate', length=280, style='design.Horizontal.TProgressbar')pb2.pack(expand=True)label2 = tk.Label(root,text='0%')label2.pack()frame=ttk.Frame(root)start_button = ttk.Button(root, text='开始', command=start)start_button.pack(side=tk.LEFT, expand=True)frame.pack(fill=tk.X, expand=True)root.mainloop()
进度条的方法start() 方法：
启动进度条的移动，设置移动的速度，以毫秒为单位。
step() 方法：
控制进度条的步长。每次调用该方法，进度条都会向前移动指定的长度，默认 1。
stop() 方法：
进度条停止，结束移动。
import tkinter as tkfrom tkinter import ttkimport timeroot = tk.Tk()root.geometry('600x400+200+200')root.title('Progressbar 进度条演示')root.grid_anchor('center')def startall(): pb1.start(5) pb2.start(10) pb3.start(5) pb4.start(10) def stepall(): pb1.step(10) pb2.step(8) pb3.step(25) pb4.step(15)def stopall(): pb1.stop() pb2.stop() pb3.stop() pb4.stop()pb1 = ttk.Progressbar(root, orient='horizontal', length=280)pb1.grid(row=0,column=0,pady=10,padx=10)pb2 = ttk.Progressbar(root, orient='horizontal', mode='indeterminate', length=280)pb2.grid(row=1,column=0,pady=10,padx=10)pb3 = ttk.Progressbar(root, orient='vertical', length=280)pb3.grid(row=0,column=1,pady=10,padx=10,rowspan=2)pb4 = ttk.Progressbar(root, orient='vertical', mode='indeterminate', length=280)pb4.grid(row=0,column=2,pady=10,padx=10,rowspan=2)start_button = ttk.Button(root, text='开始', command=startall)start_button.grid(row=2,column=0,pady=10,padx=10)start_button = ttk.Button(root, text='步进', command=stepall)start_button.grid(row=2,column=1,pady=10,padx=10)start_button = ttk.Button(root, text='停止', command=stopall)start_button.grid(row=2,column=2,pady=10,padx=10)root.mainloop()
文件下载进度示例以下代码将下载 Python 到 C 盘。
import tkinter as tkfrom tkinter import ttkfrom threading import Threadfrom urllib.request import urlretrieve, urlcleanuproot = tk.Tk()root.geometry('600x400+200+200')root.title('Progressbar 进度条演示')root.grid_anchor('center')def download(): url = "https://mirrors.huaweicloud.com/python/3.13.1/python-3.13.1-amd64.exe" urlretrieve(url, "c:\python-3.13.1-amd64.exe", download_status) urlcleanup()def download_button_clicked(): Thread(target=download).start()def download_status(count, data_size, total_data): if count == 0: progressbar.configure(maximum=total_data) else: progressbar.step(data_size) label['text']=f"{progressbar.cget('value')/total_data*100:.2f}%"download_button = ttk.Button(text="下载 Python", command=download_button_clicked)download_button.grid(row=0,column=0,pady=10,padx=10)progressbar = ttk.Progressbar(root, orient='horizontal', length=280)progressbar.grid(row=1,column=0,pady=10,padx=10)label = ttk.Label(root,text='0%')label.grid(row=1,column=1,pady=10,padx=10)root.mainloop()
