文章摘要
**列表框（Listbox）简介**
列表框（Listbox）是Tkinter中的一个组件控件，用于显示和选择多个选项。它通过`insert()`方法添加项目，支持多种选择模式（SINGLE、MULTIPLE、EXTENDED）。常用方法包括：
- `insert(index, elements)`：插入项目。
- `select_mode()`：设置选择模式，支持单选、多选、区间选择。
- `select_set(index)`：选中特定索引项。
- `get()`：返回选中项。
- `delete()`：删除项目。
**常用属性**
- `yscrollcommand`：绑定滚动条，支持滑动选择。
- `borderwidth`：设置边框宽度。
**应用示例**
1. **单选**：使用`SINGLE`模式，结合`set()`方法设置初始选择。
2. **多选**：使用`EXTENDED`模式，通过滑动选择区间。
3. **拖拽**：结合`motion`绑定处理拖拽操作，实现多选。
**快捷键**
- Alt+D：新建项目。
- Ctrl+D：删除项目。
- Shift+回车：选择区间。
总结：Listbox提供灵活的选择功能，适合多选场景，结合滚动条和事件处理，能实现复杂的选择逻辑。
目录列表框Listbox简介Listbox 的初步应用建立列表框项目 insert()Listbox的基本操作列出列表框的选项数量 size()选取特定索引项 selection_set()删除特定索引项传回指定的索引项 get()传回所选取项目的索引 curselection()检查指定索引项是否被选取 selection_includes()Listbox与事件绑定虚拟绑定应用于单选虚拟绑定应用于多选活用加入和删除项目Listbox 项目的排序拖拽 Listbox 中的项目滚动条的设计总结
列表框(Listbox)是一个显示一系列选项的Widget控件，用户可以进行单项或多项的选择
使用格式如下：
Listbox(父对象, options, …)
参数：
第一个参数：父对象，表示这个列表框将建立在哪一个窗口内第二个参数：，参数如下 参数含义borderwidth边界宽度默认是两个像素bd边界宽度默认是两个像素background背景色彩bg背景色彩cursor当鼠标光标移至列表框上时的形状foreground前景色彩fg前景色彩font字形height高，单位是字符，默认是10highlightcolor当列表框取得焦点时的颜色highlightthinckness当列表框取得焦点时的厚度listvariable以变量方式处理选项内容relief可由此控制列表框外框默认是SUNKENselectbackground被选取字符串的背景色彩selectmode可以决定有多少个选项可以被选，以及鼠标拖拽如何影响选项width宽，单位是字符宽xscrollcommand在X轴使用滚动条yscrollcommand在Y轴使用滚动条selectmode的参数
参数含义BROWSE这是默认值，我们可以选择一个选项，如果选取一个选项同时拖拽鼠标，将造成选项最后的位置是被选取的项目位置SINGLE只能选择一个选项，可以用单击方式选取，不可用拖拽方式更改所选的项目MULTIPLE可以选择多个选项，单击项目可以切换是否选择该项目EXTENDED单击第一个项目然后拖拽到最后一个项目，即可选择这个区间的一系列选项。单击可以选择第一个项目，此时若是按住Shift键并单击另一个项目，可以选取区间项目例子：
import tkinter
root=tkinter.Tk()
root.geometry(“300×180”)
# 建立listbox1
listbox1=tkinter.Listbox(root)
listbox1.pack(side=tkinter.LEFT, padx=5, pady=5)
# 建立listbox2
listbox2=tkinter.Listbox(root, height=5, relief=’raised’)
listbox2.pack(anchor=tkinter.N, side=tkinter.LEFT, padx=5, pady=5)
root.mainloop()
运行结果：
可以使用insert()方法为列表框建立项目，这个方法的使用格式如下
insert(index, elements)
参数：
第一个参数：，是项目插入的位置，如果是插在最后面可以使用END第二个参数：，插入的字符串例子：
import tkinter
root=tkinter.Tk()
# 建立listbox1
listbox1=tkinter.Listbox(root)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
listbox1.insert(tkinter.END, ‘abc’)
listbox1.insert(tkinter.END, ‘123’)
listbox1.insert(tkinter.END, ‘!$#’)
root.mainloop()
运行结果：
其实也可以这样
listbox1.insert(tkinter.END, ‘abc’, ‘123’, ‘!$#’)
运行结果也是一样的
如果有很多的项目需要插入，我们可以使用循环的方式来进行
例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
root.mainloop()
运行结果：
例子：
重新设计程序，使列表框可以多选
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.MULTIPLE)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
root.mainloop()
运行结果：
例子：
重新设计，单击一个项目，按住Shift可以选择一个区间内的项目
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
root.mainloop()
运行结果：
前面是单击并拖拽，后面是使用Shift键选择一个区间内的项目
使用，表示是在目前选项前面加入一个项目，如果尚未选择选项则此ACTIVE是0
例子：
使用ACTIVE
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
listbox1.insert(tkinter.ACTIVE, ‘豆皮’, ‘牛肉面’, ‘汤圆’)
root.mainloop()
运行结果：
显示已经在最上面了，也就是一次性在最上面插入了三个项目
下面是一些常用的Listbox 控件操作的方法
操作方法含义size()传回列表项目的数量selection_set()选取特定索引项delete()删除特定索引项get()传回指定索引项curselection()传回选取项目的索引selection_include()检查指定索引是否被选取例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
print(‘数量是：’, listbox1.size())
root.mainloop()
运行结果：
数量是： 12
如果selection_set() 方法内含一个参数，表示选取这个索引项，这个功能常被用于在建立Listbox 后，设定初次选择的项目，通俗易懂的说，就是一进去默认选的是哪一个
例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
# 这里设置默认选定的索引项
listbox1.select_set(1)
root.mainloop()
运行结果：
如果设置两个索引值，就表示选取区间选项，第一个参数是起始索引项，第二个参数是区间的结束索引项
例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
# 这里设置默认选定的索引项
listbox1.select_set(1, 3)
root.mainloop()
运行结果：
如果delete() 方法内含一个参数，表示删除这个索引项
例子
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
# 这里设置删除选定的索引项
listbox1.delete(0)
root.mainloop()
运行结果：
可以很自然的看到“热干面”选项已经不见了
如果delete() 有两个参数是，表示选取区间选项，第一个参数是区间的起始索引项，第二个参数是区间的结束索引项
例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
# 这里设置删除选定的索引项
listbox1.delete(0, 1)
root.mainloop()
运行结果：
可以看到“热干面、担担面”两个选项已经删除了
如果get() 方法内含一个参数，表示传回这个索引项的元素内容
例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
print(listbox1.get(1))
root.mainloop()
运行结果：
担担面
如果在get() 方法内有两个参数，则表示传回区间选项，第一个参数是区间的起始索引项，第二个参数是区间的结束索引项，传回的值用元组方式传回
例子：
import tkinter
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
print(listbox1.get(1, 3))
root.mainloop()
运行结果：
(‘担担面’, ‘炸酱面’, ‘面窝’)
注意！注意！是索引，不是索引项
例子：
import tkinter
def show():
index=listbox1.curselection()
print(index)
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
button=tkinter.Button(root, text=’print’, command=show)
button.pack()
root.mainloop()
运行结果：
我们可以结合get() 方法使用
例子：
def show():
index=listbox1.curselection()
for i in index:
print(listbox1.get(i))
运行结果：
如果指定索引项被选取会传回True，否则传回False
例子：
import tkinter
def show():
# 检查第二个选项有无被选取
print(listbox1.select_includes(1))
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’, ‘混沌’, ‘糊汤粉’, ‘饺子’, ‘豆皮’, ‘牛肉面’, ‘汤圆’]
# 建立listbox1
listbox1=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
listbox1.pack(padx=5, pady=5)
# 插入的位置与信息
for food in foods:
listbox1.insert(tkinter.END, food)
button=tkinter.Button(root, text=’print’, command=show)
button.pack()
root.mainloop()
运行结果：
当Listbox执行选取操作时会产生虚拟事件，可以由此设置事件处理程序
例子：
import tkinter
def show(event):
# 取得事件对象object
object=event.widget
# 取得所选的项目索引
index=object.curselection()
# 由索引取得所选的项目，关联到label中
var.set(object.get(index))
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’]
# 显示区
var=tkinter.StringVar()
label=tkinter.Label(root, textvariable=var)
label.pack(pady=5)
# 列表框
lb=tkinter.Listbox(root)
for i in foods:
lb.insert(tkinter.END, i)
lb.bind(“<<ListboxSelect>>”, show)
lb.pack(pady=5)
root.mainloop()
运行结果：
单击Listbox中选项时会产生虚拟的事件，此时可以触发方法处理此事件
其实可以省略第四行，直接使用原先的Listbox对象也可以
例子：
def show(event):
# 取得所选的项目索引
index=lb.curselection()
# 由索引取得所选的项目，关联到label中
var.set(lb.get(index))
运行结果是一样的
或者我们不使用虚拟绑定，直接简单粗鲁的使用单击选项，也行
例子：
lb.bind(“<Button-1>”, show)
运行结果是一样的！
注意：这种方式pycharm会报错，但是依旧可以运行！
例子：
import tkinter
def show(event):
object=event.widget
indexs=object.curselection()
for index in indexs:
print(object.get(index))
print(‘————‘)
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’]
# 列表框
lb=tkinter.Listbox(root, selectmode=tkinter.EXTENDED)
for i in foods:
lb.insert(tkinter.END, i)
lb.bind(“<<ListboxSelect>>”, show)
lb.pack(pady=5)
root.mainloop()
运行结果：
例子：
import tkinter
def add():
varAdd=entry.get()
if (len(varAdd.strip()))==0:
return
listbox.insert(tkinter.END, varAdd)
entry.delete(0, tkinter.END)
def delete():
index=listbox.curselection()
if len(index)==0:
return
listbox.delete(index)
root=tkinter.Tk()
# 输入框
entry=tkinter.Entry(root)
entry.grid(row=0, column=0, padx=5, pady=5)
# 增加按钮
buttonAdd=tkinter.Button(root, text=’增加’, width=10, command=add)
buttonAdd.grid(row=0, column=1, padx=5, pady=5)
# 列表显示框
listbox=tkinter.Listbox(root)
listbox.grid(row=1, column=0, padx=5, pady=5)
# 删除按钮
buttonDelete=tkinter.Button(root, text=’删除’, width=10, command=delete)
buttonDelete.grid(row=1, column=1, padx=5, pady=5, sticky=tkinter.N)
root.mainloop()
运行结果：
例子：
import tkinter
def show():
# 获取复选框是否勾选的值，如果勾选，值为True
if var.get():
# 定义排序的变量
rebBool=True
else:
rebBool=False
# 把我们列表框的几个值获取并转换成列表，方便排序
listTem=list(listbox.get(0, tkinter.END))
# 排序
sortedList=sorted(listTem, reverse=rebBool)
# 删除之前存在的列表框的值
listbox.delete(0, tkinter.END)
# 重新插入我们排序好的列表框的值
for i in sortedList:
listbox.insert(tkinter.END, i)
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’]
listbox=tkinter.Listbox(root)
for food in foods:
listbox.insert(tkinter.END, food)
listbox.pack(padx=10, pady=5)
# 创建排序按钮
button=tkinter.Button(root, text=’排序’, command=show)
button.pack(side=tkinter.LEFT, padx=10, pady=5)
var=tkinter.BooleanVar()
cheakbutton=tkinter.Checkbutton(root, text=’从大到小排序’, variable=var)
cheakbutton.pack(side=tkinter.LEFT)
root.mainloop()
运行结果：
例子：
import tkinter
# 处理单击选项
def show(event):
# nearest可以传回最接近y坐标在Listbox的索引
# 传回目前选项的索引
listbox.index=listbox.nearest(event.y)
# 处理拖拽选项
def showInfo(event):
# 获取目前选项的新索引
newIndex=listbox.nearest(event.y)
# 判断，如果向上拖拽
if newIndex < listbox.index:
# 获取新位置的内容
x=listbox.get(newIndex)
# 删除新内容
listbox.delete(newIndex)
# 将新内容插入，相当于插入我们移动后的位置
listbox.insert(newIndex + 1, x)
# 把需要移动的索引值变成我们所希望的索引，达到了移动的目的
listbox.index=newIndex
elif newIndex > listbox.index:
# 获取新位置的内容
x=listbox.get(newIndex)
# 删除新内容
listbox.delete(newIndex)
# 将新内容插入，相当于插入我们移动后的位置
listbox.insert(newIndex – 1, x)
# 把需要移动的索引值变成我们所希望的索引，达到了移动的目的
listbox.index=newIndex
root=tkinter.Tk()
foods=[‘热干面’, ‘担担面’, ‘炸酱面’, ‘面窝’, ‘油条’, ‘豆浆’]
listbox=tkinter.Listbox(root)
for food in foods:
listbox.insert(tkinter.END, food)
listbox.bind(‘<Button-1>’, show)
listbox.bind(‘<B1-Motion>’, showInfo)
listbox.pack(padx=10, pady=5)
root.mainloop()
运行结果：
程序中用到的方法
nearest(event.y)
上述代码行，可以传回最接近y坐标在Listbox中的索引。当有单击操作时会触发方法，第4行可以传回目前选项的索引，在拖拽过程中会触发方法，在第7行可以传回新选项的索引，因为在拖拽过程中，这个方法会不断的被触发，所以至于被触发多少次视移动速度而定
假如移动担担面，它的索引是1， 咱们向下拖拽，整个流程如下
新索引位置为2获得索引内容 ‘面窝’，参照第27行删除新内容 ‘面窝’，参照第29行将 ‘面窝’ 内容插入在索引1的位置，相当于插入到我们移动前的位置，参照第31行这个时候把新的索引位置传给 ‘担担面’ ，根据索引来变换位置，变成了2，这样就达到了移动的目的了，参照第33行在默认环境中Listbox 是没有滚动条的，但是如果选项太多，将造成部分选项无法显示，可以将滚动条Scrollbar控件加入Listbox中
注：Scrollbar控件除了可以应用在Listbox上，也可以应用在Text和Canvas上
使用格式如下:
Scrollbar(父对象, options, …)
参数：
第一个参数：父对象，表示这个滚动条将建立在哪一个窗口内第二个参数：，参数如下 参数含义activebackground当光标经过滚动条时，滚动条和方向箭头的颜色bg 或 background当光标没有经过滚动条时，滚动条和方向箭头的颜色bd 或 borderwidth边界宽度默认是两个像素command滚动条移动时所触发的方法cursor当鼠标光标在滚动条上时的形状highlightbackground当滚动条没有获得焦点时的颜色highlightcolor当滚动条取得焦点时的颜色highlightthinckness当取得焦点时的厚度默认是1jump每次短距离的拖拽滚动条时都会触发command的方法如果设为1，则只有放开鼠标按键时，才会触发command的方法默认是0orient可设置HORIZONTAL/VERTICAL，分别是水平轴/垂直轴repeatdelay可以设置按住滚动条移动的停滞时间单位是ms默认是300mstakefocus正常可以用Tab键的方式切换滚动条成为焦点如果设置为0，则取消此设置troughcolor滚动条槽的颜色width宽，单位是字符宽例子：
import tkinter
root=tkinter.Tk()
sc=tkinter.Scrollbar(root)
sc.pack(side=tkinter.RIGHT, fill=tkinter.Y)
# 列表动，滚动条跟着动
lb=tkinter.Listbox(root, yscrollcommand=sc.set)
for i in range(50):
lb.insert(tkinter.END, “列表 ” + str(i))
lb.pack(side=tkinter.LEFT, fill=tkinter.BOTH, expand=True)
# 滚动条动，列表跟着动
sc.config(command=lb.yview)
root.mainloop()
运行结果：
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
您可能感兴趣的文章:Python之tkinter进度条Progressbar用法解读Python之tkinter文字区域Text使用及说明Python使用tkinter写一个本地密码管理器Python+Tkinter实现简单的画图软件