13 Listbox 组件

13 Listbox 组件

Tkinter 的 Listbox 组件是一个用于显示列表项的控件，用户可以从中选择一个或多个项目。以下是对 Listbox 组件的详细说明和一个使用案例。

Listbox 组件属性

基本属性

• width: 控件的宽度，通常以字符数为单位。
• height: 控件的高度，以行数为单位。

选择模式

• selectmode: 控制选择模式，可以是 “single”（单选）、“browse”（单选，但允许连续滚动）、“multiple”（多选）、“extended”（多选，通过Shift和Ctrl键）。

事件处理

• bind(sequence, callback, add=False): 绑定事件到回调函数，如双击事件。

项目操作

• insert(index, *elements): 在指定位置插入一个或多个元素。
• delete(first, last=None): 删除指定范围的元素。
• get(index): 获取指定索引位置的元素。

选择控制

• selection_get(): 获取当前选中的元素。
• selection_set(indexes): 设置选中的元素。
• selection_add(indexes): 添加元素到选中集合。
• selection_remove(indexes): 从选中集合中移除元素。

使用案例

以下是一个简单的使用案例，创建一个带有Listbox组件的窗口，允许用户选择列表中的项目。

import tkinter as tk   # 导入tkinter模块，并简称为tk

def on_double_click(event):   # 定义一个函数，用于处理双击事件
    # 获取双击的Listbox项
    selected_item = listbox.get(listbox.curselection())   # 获取当前选中的Listbox项
    print(f"Double clicked item: {selected_item}")   # 打印双击的项目

root = tk.Tk()   # 创建Tkinter的主窗口实例
root.title("Listbox Example")   # 设置窗口标题为"Listbox Example"

# 创建Listbox组件
listbox = tk.Listbox(root, width=50, height=10, selectmode=tk.EXTENDED)   # 创建Listbox组件，设置宽度为50字符，高度为10行，选择模式为多选
listbox.pack()   # 将Listbox组件添加到窗口中

# 向Listbox添加项目
items = ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"]   # 创建一个包含项目的列表
for item in items:   # 遍历列表中的每个项目
    listbox.insert(tk.END, item)   # 将项目添加到Listbox的末尾

# 绑定双击事件
listbox.bind("<Double-1>", on_double_click)   # 绑定双击事件到on_double_click函数

root.mainloop()   # 启动Tkinter事件循环，显示窗口并等待用户操作

在这个案例中，我们创建了一个Listbox组件，并设置了其宽度和高度。我们添加了五个项目到Listbox中，并且设置了选择模式为tk.EXTENDED，允许用户通过Shift和Ctrl键进行多选。我们还绑定了一个双击事件，当用户双击Listbox中的任何项目时，会触发on_double_click函数，并打印出被双击的项目。

通过这个例子，你可以看到如何使用 Listbox 组件来创建一个基本的列表选择界面，并通过事件处理来响应用户的操作。你可以根据需要扩展这个例子，添加更多的功能和样式。