一、组件简介
Listbox组件,列表框,可用于显示一个包含多个文本选项的选择列表。根据选择模式设置,用户可以从列表中选择一个或多个选项。
在功能上,Listbox跟Checkbutton与Radiobutton有相似之处,但是Listbox是以列表形式来呈现选项,后面两个是通过按钮形式提供选项。
比如下面这个,这就是一个Listbox。
需要注意的,Listbox只能包含文本选项,且所有的选项只能是相同的字体和颜色。
二、运用实例
下面我们就来初步了解Listbox组件的使用,但是在本次案例中没有涉及到滚动条的知识,这个会在Scrollbar组件中专门详解。
——
1. Listbox基操
import tkinter as tk
root = tk.Tk()
tk.Label(root, text='今天周末吃点啥?').pack(anchor='w')
# 创建选项列表
Foods = ['鱼香肉丝','红烧肉','毛血旺','干煸肥肠']
lb = tk.Listbox(root) # 创建Listbox
# 利用for循环添加列表中的选项到Listbox
for food in Foods:
lb.insert('end',food) # insert方法添加列表元素, end表示添加到最后一行
lb.pack()
root.mainloop()
运行程序,显示如下:
因为这里我们并没有设置选择模式,所以默认是单选。
同时还需要重点强调的是,在Listbox中我们使用insert()方法来添加文本选项,该方法有两个参数:第一个是插入的索引号;第二个是插入的字符串。
其中,索引号是项目的序号,第一项的序号是0。
当然这里有一些特殊的索引号:比如 active 表示选中的项目(如果 Listbox 允许多选,那么它表示最后一个被选中的项目);又如上面代码中的 end 表示 Listbox 的最后一行,所以当要插入一个项目到列表时可以使用 end。
——
2. 四种选择模式
重点来讲讲Listbox中四种选择模式
selectmode
single 单选
browse 也是单选,但拖动鼠标或通过方向键可以直接改变选项)
multiple 多选
extended 也是多选,但需要同时按住 Shift 键或 Ctrl 键或拖拽鼠标实现。
默认情况下是 browse
import tkinter as tk
root = tk.Tk()
tk.Label(root, text='今天周末吃点啥?').pack(anchor='w')
# 创建选项列表
Foods = ['鱼香肉丝','红烧肉','毛血旺','干煸肥肠']
# selectmode有四种值,single、browse(默认)、multiple、extended
lb = tk.Listbox(root, selectmode='entended') # 创建Listbox
# 利用for循环添加列表中的选项到Listbox
for food in Foods:
lb.insert('end',food) # insert方法添加列表元素, end表示添加到最后一行
lb.pack()
root.mainloop()
具体效果可以自行复制代码手动运行体验一下
——
3. 删除选项操作
最后我们再升级一下,增加一个能够删除选项的按钮
import tkinter as tk
root = tk.Tk()
tk.Label(root, text='今天周末吃点啥?').pack(anchor='w')
# 创建选项列表
Foods = ['鱼香肉丝','红烧肉','毛血旺','干煸肥肠']
# selectmode有四种值,single、browse(默认)、multiple、extended
lb = tk.Listbox(root, selectmode='entended') # 创建Listbox
# 利用for循环添加列表中的选项到Listbox
for food in Foods:
lb.insert('end',food) # insert方法添加列表元素, end表示添加到最后一行
lb.pack()
# 利用lambda表达式删除当前活动选项
theButton = tk.Button(root, text='删除', \
command=lambda x=lb:x.delete("active"))
theButton.pack()
root.mainloop()
运行程序,我们操作一下:
三、参数方法
1. 参数汇总
归纳总结Listbox组件中一些常用的参数以及用法。
——
2. 方法汇总
activate(index)
将给定索引号对应的选项激活(在其文本下方画一条下划线)
bbox(index)
返回给定索引号对应的选项的边框
返回值是一个以像素为单位的 4 元祖表示边框:(xoffset, yoffset, width, height)
xoffset 和 yoffset 表示距离左上角的偏移位置
返回的 width 是文本的实际宽度(像素为单位)
如果指向的选项是不可见的,那么返回值是 None
curselection()
返回一个元组,包含被选中的选项的序号(从 0 开始)
如果没有选中任何选项,返回一个空元组
delete(first, last=None)
删除参数 first 到 last 范围内(包含 first 和 last)的所有选项
如果忽略 last 参数,表示删除 first 参数指定的选项
get(first, last=None)
返回一个元组,包含参数 first 到 last 范围内(包含 first 和 last)的所有选项的文本
如果忽略 last 参数,表示返回 first 参数指定的选项的文本
index(index)
返回与 index 参数相应的选项的序号(例如 lb.index(END))
insert(index, *elements)
添加一个或多个项目到 Listbox 中
使用 lb.insert(END) 添加新选项到末尾
itemcget(index, option)
获得 index 参数指定的项目对应的选项(由 option 参数指定)
itemconfig(index, **options)
设置 index 参数指定的项目对应的选项(由可变参数 **option 指定)
nearest(y)
返回与给定参数 y 在垂直坐标上最接近的项目的序号
scan_dragto(x, y)
见下方 scan_mark(x, y)
scan_mark(x, y)
使用这种方式来实现 Listbox 内容的滚动
需要将鼠标按钮事件及当前鼠标位置绑定到 scan_mark(x, y) 方法,然后再将 事件及当前鼠标位置绑定到 scan_dragto(x, y) 方法,就可以实现 Listbox 在当前位置和 sacn_mack(x, y) 指定的位置 (x, y) 之间滚动
see(index)
调整列表框的位置,使得 index 参数指定的选项是可见的
select_anchor(index)
与 selection_anchor(index) 相同,见下方解释
select_clear(first, last=None)
与 selection_clear(first, last=None) 相同,见下方解释
select_includes(index)
与 selection_includes(index) 相同,见下方解释
select_set(first, last=None)
与 selection_set(first, last=None) 相同,见下方解释
selection_anchor(index)
在 index 参数的位置下一个锚点,此后你就可以通过特殊索引 ANCHOR 访问
selection_clear(first, last=None)
取消参数 first 到 last 范围内(包含 first 和 last)选项的选中状态
如果忽略 last 参数,则只取消 first 参数指定选项的选中状态
selection_includes(index)
返回 index 参数指定的选项的选中状态
返回 1 表示选中,返回 0 表示未选中
selection_set(first, last=None)
设置参数 first 到 last 范围内(包含 first 和 last)选项为选中状态
如果忽略 last 参数,则只设置 first 参数指定选项为选中状态
size()
返回 Listbox 组件中选项的数量
xview(*args)
该方法用于在水平方向上滚动 Listbox 组件的内容,一般通过绑定 Scollbar 组件的 command 选项来实现
如果第一个参数是 MOVETO,则第二个参数表示滚动到指定的位置:0.0 表示最左端,1.0 表示最右端
如果第一个参数是 SCROLL,则第二个参数表示滚动的数量,第三个参数表示滚动的单位(可以是 UNITS 或 PAGES),例如:xview(SCROLL, 3, UNITS) 表示向右滚动三行
xview_moveto(fraction)
跟 xview(MOVETO, fraction) 一样
xview_scroll(number, what)
跟 xview(SCROLL, number, what) 一样
yview(*args)
该方法用于在垂直方向上滚动 Listbox 组件的内容,一般通过绑定 Scollbar 组件的 command 选项来实现
如果第一个参数是 MOVETO,则第二个参数表示滚动到指定的位置:0.0 表示最顶端,1.0 表示最底端
如果第一个参数是 SCROLL,则第二个参数表示滚动的数量,第三个参数表示滚动的单位(可以是 UNITS 或 PAGES),例如:yview(SCROLL, 3, PAGES) 表示向下滚动三页
yview_moveto(fraction)
跟 yview(MOVETO, fraction) 一样
yview_scroll(number, what)
跟 yview(SCROLL, number, what) 一样
原文链接:https://blog.csdn.net/nilvya/article/details/105609970