第14章 列表框（Listbox）
列表框控件显示多行文本，用户可以选中一行或者多行。所有的文本只能使用一种字体，不能混合使用多种字体。
14.1 属性
常用的参数列表如下：

属性	描述
activestyle	被选中的文本的样式： underline: 下划线 dotbox：点划线框 none: 没有任何的样式
background bg	背景颜色。默认是系统指定颜色
borderwidth bd	边框宽度。一般是1~2个像素值。
cursor	当鼠标移动经过列表框的时候，显示的光标样式
disabledforeground	列表框被禁止使用的时候的背景颜色
exportselection	默认是1。
font	列表框中文字的字体。只能选择一种字体显示。
foreground fg 列表框中文字的颜色
height	设置列表框的高度。默认值是10。
highlightbackground	当列表框失去焦点的时候，边框的高亮颜色
highlightcolor	当列表框获得焦点的时候，边框的高亮颜色
highlightthickness	设置高亮边框的宽度
listvariable	设置listvariable属性
relief	边框的美化效果。默认值是SUNKEN，其他的可选项包括：FLAT, RAISED, GROOVE, and RIDGE
selectbackground	选中的条目背景颜色
selectborderwidth	选中的条目，会用一个虚线的矩形框住。此参数定义矩形边框的宽度。默认值是1。
selectforeground	选中条目的文本颜色
selectmode	选择模式： MULTIPLE为多选 BROWSE：通过鼠标的移动选择 SINGLE:只能选一行。鼠标不能拖动选择。 EXTENDED：shift和ctrl配合使用
takefocus	标识用户是否能够使用Tab键移动焦点到标签上。默认是空字符串，也就是只有使用热键才能选中该按钮。
state	标签的状态，包括：NORMAL或者 DISABLED
width	设置列表框的宽度。默认值为20
xscrollcommand	与滚动条组件相关联（水平方向）.使用方法可以参考：Scrollbar 组件
yscrollcommand	与滚动条组件相关联（垂直方向）.使用方法可以参考：Scrollbar 组件
14.1.1 activestyle
设置列表框被选中的文本行的显示效果。有三种：
underline: 下划线
dotbox：点划线虚框
none: 没有显示效果

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,activestyle='dotbox')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

14.1.2 background(bg)
设置列表框背景颜色。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,bg='green')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

14.1.3 borderwidth(bd)
设置列表框的边框宽度。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,bd=10)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

14.1.4 cursor
鼠标位于列表框区域时，鼠标的形状。详细的cursor说明见3.3.6节。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,cursor='spider')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

14.1.5 disabledforeground
列表框的状态为tk.DISABLED时，列表框的文本颜色。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,disabledforeground='red')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
b1.config(state=tk.DISABLED)
root.mainloop()

结果：

14.1.6 exportselection
决定是否可以复制选中的文本内容。如果exportselection=True，表示可以。exportselection=False，表示不可复制列表框中选中的选项。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')

b1=tk.Listbox(root,exportselection=0)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

14.1.7 font
设置列表框字体。所有的文本只能有一种字体，不能混合多种字体。具体的文本说明见3.3.3节。
14.1.8 foreground(fg)
设置列表框中的文本颜色。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,fg='blue')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

14.1.9 height
设置列表框的高度。单位是行。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,height=5)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

设置列表框的高度。默认是10行。
14.1.10 highlightbackground、highlightcolor和highlightthickness
设置列表框获得或者失去输入焦点时候的边框颜色。这两种边框的宽度由highlightthickness设置。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')

b1=tk.Listbox(root,highlightbackground='blue',
              highlightcolor='red',highlightthickness=10)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()

root.mainloop()

结果：


14.1.11 listvariable
listvariable 可以与一个tk.StringVar()变量相关联。可以通过变量的get()方法，获得列表框中的所有的文本内容。也可以通过set(s)的方法来设置列表框中的内容。

#获得列表框的内容
import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
content=tk.StringVar()
b1=tk.Listbox(root,listvariable=content)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
print(content.get())
root.mainloop()

#设置列表框中的内容
import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
content=tk.StringVar()
b1=tk.Listbox(root,listvariable=content)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
def lst():
    content.set('abc def "c c"     c bbb')
b2=tk.Button(root,text='Set',command=lst)
b2.pack()
root.mainloop()

结果：

说明：
（1）使用set(s)会取代以前的列表框中的内容
（2）s是用空格分隔的字符串。多个空格会被认为是1个。如果选项中需要有空格，请用引号把这个字符串括起来。比如”c c”。
14.1.12 relief
设置列表框边框的3D效果。见3.3.5节的说明
14.1.13 selectbackground
选中条目的背景颜色。默认值是蓝色。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,selectbackground='red')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

14.1.14 selectborderwidth
表示选中的矩形的边框宽度。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,selectborderwidth=5)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

说明：可以看到间距明显比不设置selectborderwidth加大了。
14.1.15 selectforeground
选中后的文本颜色。目前是反白的显示，也可以通过selectforeground来设定。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')
b1=tk.Listbox(root,selectforeground='red')
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

结果：

14.1.16 selectmode
设定列表框中条目的选择模式：
（1）tk.BROWSE: 可以通过鼠标拖动的方式选择条目。一次只能选中一行
（2）tk.SINGLE: 一次只能选中一个条目。不支持鼠标拖动模式选择。
（3）tk.MULTIPLE: 可以选择多个条目。如果该条目已经选中，再次点击变为未选中
（4）tk.EXTENDED ：支持使用如下模式选择：
拖动选择。鼠标拖动，在鼠标经过的条目都被选中
Shift：先鼠标点击选中一个条目，然后按照shift键，鼠标点击另外的条目，则这2个条目之间的所有条目都被选中
Ctrl: 按住ctrl键，同时点击一个条目，则该条目被选中。一次只能增加一个被选中的条目。如果该条目已经被选中，则状体变为未选中。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')

b1=tk.Listbox(root,selectmode=tk.SINGLE)
for i in range(1,11):
    b1.insert(tk.END,i)
b1.pack()
root.mainloop()

14.1.17 takefocus
设置是否可以通过Tab移动输入焦点到列表框上。
14.1.18 state
设置列表框的状态。有二种：DISABLED或者NORMAL。
14.1.19 width
设置列表框的宽度。默认是20个字符。
14.1.20 xscrollcommand
设置水平滚动条。详细的用法见yscrollcommand。
14.1.21 yscrollcommand
设置垂直滚动条。

import tkinter as tk
root=tk.Tk()
root.geometry('300x240')

content=tk.StringVar()
content.set('1 2 3 jjjjjjjjjjjjjjjjjjjjjjjjjjj\
jjjjjjjjjjjjjj 4 5 6 7 8 9 10')
f=tk.Frame(root)
s1 = tk.Scrollbar(f,orient=tk.HORIZONTAL)  
s2 = tk.Scrollbar(f,orient=tk.VERTICAL)  
b1 = tk.Listbox(f,width=10,height=5,listvariable=content,
                xscrollcommand=s1.set,yscrollcommand=s2.set)
s1.pack(side=tk.BOTTOM,fill=tk.X) 
s1.config(command=b1.xview)
s2.pack(side=tk.RIGHT,fill=tk.Y) 
s2.config(command=b1.yview)
b1.pack()
f.pack()
root.mainloop()

结果：