TUTORIAL · Tkinter
Tkinter 教程 - 下拉列表
Python Tkinter 下拉列表教程
本页内容
ttk.Combobox 是一个带有下拉选择列表的 Tkinter 字段。设置其 values 选项来填充列表,调用 current(index) 按位置选择,并使用 get() 读取显示的文本。填充后的列表不会自动选择其第一项。下面的简短 Python 示例在不创建窗口的情况下说明了索引与文本的关系;本指南中的实际小部件代码片段以行内方式显示,因为所提供的执行环境没有图形显示。对于选择回调,请绑定确切的虚拟事件名称 <<ComboboxSelected>>,以便当用户选择一项时您的处理程序能作出响应。(<<ComboboxSelected>>)
Python Tkinter ttk.Combobox 示例
这个小示例展示了显式选择如何与其位置和显示文本相对应。它在不打开 Tk 窗口的情况下运行。
months = ["January", "February", "March", "April"]
selected_index = 1
selected_text = months[selected_index]
print(selected_index, selected_text)
1 February
对于小部件,用 from tkinter import ttk 导入 ttk,用 ttk.Combobox(parent, values=months) 创建它,并用 combo.current(1) 设置初始选择。不带参数的 current() 方法返回所选项目的索引;get() 返回其显示的文本。在默认的 normal 状态下,用户可以输入一个不在列表中的值:此时 get() 返回该文本,当它与列表项不匹配时 current() 返回 -1。
为 Combobox 及其列表设置字体
font 选项设置 Combobox 字段的样式。它的下拉列表是一个单独的 Tk 列表框,因此请用 *TCombobox*Listbox.font 选项模式来配置该列表。例如,为字段创建一个字体元组,如 ("Courier", 16, "bold"),然后在打开列表之前用 app.option_add("*TCombobox*Listbox.font", ("Courier", 14)) 设置根窗口选项。当字段和列表需要不同的大小或粗细时,使用单独的元组。字体家族的可用性取决于操作系统,系统可能会替换为已安装的字体。
仅设置 Combobox 的 font 可能会使列表文本保持其系统默认字体。在下拉列表首次打开之前配置列表框选项,以便控件的两个部分都使用预期的样式。
将回调绑定到 Combobox 选择
Tkinter 将选择虚拟事件命名为 <<ComboboxSelected>>。用 combo.bind("<<ComboboxSelected>>", show_selection) 绑定这个确切的名称,以便在用户从列表中选择一项后运行一个函数。将回调定义为接受 Tkinter 的事件对象,例如 def show_selection(event): print("Selected:", event.widget.get())。当用户选择 March 时,回调会打印 Selected: March。该事件在用户从列表中选择时生成;在代码中用 current() 设置值并不代表用户选择了一个项目。
回调通过 event.widget 读取发出事件的小部件,因此在需要时也可以为多个 Combobox 重用。让回调专注于对选择的响应,例如更新相关标签或重新计算表单值。
在列表打开前更新 Combobox 的值
当每当用户打开下拉列表时都应刷新选项时,使用 postcommand 选项。Tkinter 在显示列表之前立即调用所赋予的函数,使其可以替换 combo["values"]。例如,refresh_months() 函数可以赋值 ["July", "August", "September", "October"];将其作为 postcommand=refresh_months 传递给构造函数。
postcommand 在列表显示之前运行,而不是在窗口创建时运行。初始列表可以包含 January 到 April,然后其首次打开会将可用选项更新为 July 到 October。仅因为选项已更改,显示的文本不会自动成为选择。保持回调快速,因为它作为打开下拉列表的一部分运行。
将 Combobox 设为只读或禁用
Combobox 默认使用 state="normal",这允许用户在其字段中输入并选择列表项。设置 state="readonly" 可防止输入,同时仍允许从列表中进行选择。当控件应不可用时设置 state="disabled";Tkinter 会将其呈现为非活动状态并阻止交互。例如,用 ttk.Combobox(app, values=months, state="normal")、state="readonly" 或 state="disabled" 创建控件,以在窗口中比较这些模式。
当值必须来自所提供的选项、但用户仍应能够更改它时,使用 readonly。当值暂时不可用或控件仅用于信息展示时,使用 disabled。禁用的 Combobox 无法打开或编辑;将其状态改回 normal 或 readonly 可恢复交互。有关可与表单配合使用的更多 Tkinter 小部件,请参阅 Tkinter Entry 教程 和 Tkinter Button 教程。