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。

Tkinter 教程 Combobox 基礎

為 Combobox 及其清單設定字型

font 選項設定 Combobox 欄位的樣式。它的下拉清單是一個單獨的 Tk 清單方塊,因此請用 *TCombobox*Listbox.font 選項模式來設定該清單。例如,為欄位建立一個字型元組,如 ("Courier", 16, "bold"),然後在開啟清單之前用 app.option_add("*TCombobox*Listbox.font", ("Courier", 14)) 設定根視窗選項。當欄位和清單需要不同的大小或粗細時,使用單獨的元組。字型家族的可用性取決於作業系統,系統可能會替換為已安裝的字型。

Tkinter 教程 Combobox 設定字型

僅設定 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。僅因為選項已更改,顯示的文字不會自動成為選取。保持回呼快速,因為它作為開啟下拉清單的一部分執行。

Tkinter 教程 Combobox postcommand

將 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 教程。