GUI

[Python Tkinter] コンボボックスの使い方をわかりやすく解説

PythonのTkinterライブラリでコンボボックスを使用するには、ttkモジュールのComboboxウィジェットを使います。

コンボボックスは、ユーザーが選択可能なドロップダウンリストを提供するウィジェットです。

まず、from tkinter import ttkでttkモジュールをインポートし、Comboboxを作成します。

values引数にリストを渡すことで、選択肢を設定できます。

選択された値はget()メソッドで取得可能です。

目次から探す

コンボボックスとは
Tkinterでコンボボックスを作成する方法
コンボボックスの基本操作
コンボボックスのイベント処理
コンボボックスのカスタマイズ
コンボボックスの応用例
まとめ

コンボボックスとは

コンボボックスは、ユーザーが選択肢の中から1つを選ぶことができるウィジェットです。

ドロップダウンリストの形式で表示され、選択肢をクリックすることで展開されます。

これにより、ユーザーは限られたスペースで多くの選択肢を提供することができます。

コンボボックスの基本的な役割

ユーザーが選択肢から1つを選ぶことを可能にする
スペースを節約し、インターフェースをシンプルに保つ
選択肢を動的に変更できる柔軟性を持つ

コンボボックスとリストボックスの違い

特徴	コンボボックス	リストボックス
表示形式	ドロップダウン形式	常に選択肢が表示される
スペースの使用	スペースを節約	多くのスペースを必要とする
選択肢の数	限られた数の選択肢を表示可能	多くの選択肢を同時に表示可能
ユーザーの操作	クリックで展開、選択	マウスまたはキーボードで選択

Tkinterでのコンボボックスの位置づけ

TkinterはPythonの標準GUIライブラリであり、コンボボックスはその中で提供されるウィジェットの一つです。

Tkinterのttkモジュールを使用することで、スタイリッシュで機能的なコンボボックスを簡単に作成できます。

コンボボックスは、ユーザーインターフェースにおいて、選択肢を提供する重要な要素として位置づけられています。

Tkinterでコンボボックスを作成する方法

Tkinterを使用してコンボボックスを作成するための手順を以下に示します。

これにより、簡単にGUIアプリケーションにコンボボックスを追加できます。

Tkinterのインポートと基本設定

まず、Tkinterをインポートし、基本的なウィンドウを設定します。

以下のコードは、Tkinterの基本的なウィンドウを作成する方法を示しています。

import tkinter as tk
# メインウィンドウの作成
root = tk.Tk()
root.title("コンボボックスの例")
root.geometry("300x200")

ttkモジュールのインポート

Tkinterのttkモジュールをインポートすることで、スタイリッシュなウィジェットを使用できます。

コンボボックスもこのモジュールから提供されます。

from tkinter import ttk
# ttkモジュールのインポート

Comboboxウィジェットの作成

次に、ttk.Comboboxを使用してコンボボックスを作成します。

以下のコードでは、コンボボックスをウィンドウに追加しています。

# コンボボックスの作成
combo = ttk.Combobox(root)
combo.pack(pady=20)  # ウィンドウに配置

コンボボックスに選択肢を設定する

コンボボックスに選択肢を設定するには、valuesプロパティを使用します。

以下のコードでは、いくつかの選択肢を追加しています。

# コンボボックスに選択肢を設定
combo['values'] = ("選択肢1", "選択肢2", "選択肢3")

コンボボックスの初期値を設定する

コンボボックスの初期値を設定するには、currentメソッドを使用します。

以下のコードでは、最初の選択肢を初期値として設定しています。

# コンボボックスの初期値を設定
combo.current(0)  # 最初の選択肢を選択

これで、基本的なコンボボックスが作成されました。

次に、ウィンドウを表示するためのメインループを追加します。

# メインループの開始
root.mainloop()

このコードを実行すると、選択肢を持つコンボボックスが表示されます。

コンボボックスの基本操作

コンボボックスを使用する際の基本的な操作方法について解説します。

これにより、ユーザーの選択を取得したり、選択肢を動的に変更したりすることができます。

コンボボックスから選択された値を取得する

コンボボックスから選択された値を取得するには、getメソッドを使用します。

以下のコードでは、ボタンをクリックしたときに選択された値を表示する例を示します。

import tkinter as tk
from tkinter import ttk
def show_selection():
    selected_value = combo.get()  # 選択された値を取得
    print(f"選択された値: {selected_value}")
root = tk.Tk()
combo = ttk.Combobox(root, values=("選択肢1", "選択肢2", "選択肢3"))
combo.pack(pady=20)
button = tk.Button(root, text="選択を表示", command=show_selection)
button.pack(pady=10)
root.mainloop()

選択された値: 選択肢1

コンボボックスの選択肢を動的に変更する

コンボボックスの選択肢を動的に変更するには、['values']プロパティを再設定します。

以下のコードでは、ボタンをクリックすることで選択肢を変更する例を示します。

def change_options():
    combo['values'] = ("新しい選択肢1", "新しい選択肢2", "新しい選択肢3")
    combo.current(0)  # 新しい選択肢の最初を選択
button_change = tk.Button(root, text="選択肢を変更", command=change_options)
button_change.pack(pady=10)

コンボボックスの選択肢をクリアする

コンボボックスの選択肢をクリアするには、['values']プロパティに空のリストを設定します。

以下のコードでは、ボタンをクリックすることで選択肢をクリアする例を示します。

def clear_options():
    combo['values'] = []  # 選択肢をクリア
button_clear = tk.Button(root, text="選択肢をクリア", command=clear_options)
button_clear.pack(pady=10)

コンボボックスの状態を変更する(読み取り専用、通常、無効)

コンボボックスの状態を変更するには、stateプロパティを使用します。

以下のコードでは、コンボボックスを通常、読み取り専用、無効の状態に変更する例を示します。

def set_readonly():
    combo.state(['readonly'])  # 読み取り専用に設定
def set_normal():
    combo.state(['!readonly'])  # 通常に戻す
def set_disabled():
    combo.state(['disabled'])  # 無効に設定
button_readonly = tk.Button(root, text="読み取り専用にする", command=set_readonly)
button_readonly.pack(pady=10)
button_normal = tk.Button(root, text="通常に戻す", command=set_normal)
button_normal.pack(pady=10)
button_disabled = tk.Button(root, text="無効にする", command=set_disabled)
button_disabled.pack(pady=10)

これらの操作を組み合わせることで、コンボボックスを効果的に活用することができます。

コンボボックスのイベント処理

コンボボックスでは、ユーザーの操作に応じて特定の処理を実行するためのイベント処理が重要です。

ここでは、イベントバインディングの基本から、選択変更時のイベント発生、選択された値に応じた処理の分岐について解説します。

イベントバインディングの基本

Tkinterでは、ウィジェットに対して特定のイベントをバインドすることで、ユーザーの操作に応じた処理を実行できます。

バインディングは、bindメソッドを使用して行います。

以下のコードは、コンボボックスに対して選択変更イベントをバインドする例です。

def on_combobox_select(event):
    print("選択が変更されました")
combo.bind("<<ComboboxSelected>>", on_combobox_select)  # 選択変更イベントをバインド

コンボボックスの選択変更時にイベントを発生させる

コンボボックスの選択が変更されたときに特定の処理を実行するには、先ほどのon_combobox_select関数を使用します。

以下のコードでは、選択が変更されたときに選択された値を表示する例を示します。

def on_combobox_select(event):
    selected_value = combo.get()  # 選択された値を取得
    print(f"選択された値: {selected_value}")
combo.bind("<<ComboboxSelected>>", on_combobox_select)  # 選択変更イベントをバインド

選択された値に応じて処理を分岐させる

選択された値に応じて異なる処理を実行するには、if文を使用して条件分岐を行います。

以下のコードでは、選択された値に応じて異なるメッセージを表示する例を示します。

def on_combobox_select(event):
    selected_value = combo.get()  # 選択された値を取得
    if selected_value == "選択肢1":
        print("選択肢1が選ばれました")
    elif selected_value == "選択肢2":
        print("選択肢2が選ばれました")
    elif selected_value == "選択肢3":
        print("選択肢3が選ばれました")
combo.bind("<<ComboboxSelected>>", on_combobox_select)  # 選択変更イベントをバインド

これにより、ユーザーがコンボボックスで選択を変更するたびに、選択された値に応じた処理が実行されます。

イベント処理を活用することで、よりインタラクティブなアプリケーションを作成することができます。

コンボボックスのカスタマイズ

コンボボックスは、見た目や動作をカスタマイズすることで、ユーザーインターフェースをより魅力的にすることができます。

ここでは、コンボボックスの幅や高さの調整、フォントや色の変更、ツールチップの追加について解説します。

コンボボックスの幅や高さを調整する

コンボボックスの幅や高さは、widthおよびheightプロパティを使用して調整できます。

以下のコードでは、コンボボックスの幅を指定しています。

combo = ttk.Combobox(root, width=30)  # 幅を30に設定
combo.pack(pady=20)

高さは、heightプロパティを使用して設定できますが、ttk.Comboboxでは表示される選択肢の数を指定することで間接的に高さを調整します。

combo['values'] = ("選択肢1", "選択肢2", "選択肢3", "選択肢4", "選択肢5")
combo['height'] = 5  # 表示する選択肢の数を5に設定

コンボボックスのフォントや色を変更する

コンボボックスのフォントや色を変更するには、styleを使用します。

以下のコードでは、フォントと背景色を変更する方法を示します。

style = ttk.Style()
style.configure("TCombobox", font=("Helvetica", 12), foreground="black", background="lightblue")
combo = ttk.Combobox(root, style="TCombobox")
combo.pack(pady=20)

このコードでは、フォントを Helvetica のサイズ12に設定し、前景色を黒、背景色を水色に変更しています。

コンボボックスにツールチップを追加する

ツールチップは、ユーザーがコンボボックスにマウスをホバーしたときに表示される補足情報です。

Tkinterには標準でツールチップ機能はありませんが、簡単に実装できます。

以下のコードは、ツールチップを追加する方法を示しています。

class ToolTip:
    def __init__(self, widget, text):
        self.widget = widget
        self.text = text
        self.tooltip_window = None
        self.widget.bind("<Enter>", self.show_tooltip)
        self.widget.bind("<Leave>", self.hide_tooltip)
    def show_tooltip(self, event=None):
        if self.tooltip_window is not None:
            return
        x = self.widget.winfo_rootx() + 20
        y = self.widget.winfo_rooty() + 20
        self.tooltip_window = tk.Toplevel(self.widget)
        self.tooltip_window.wm_overrideredirect(True)
        self.tooltip_window.wm_geometry(f"+{x}+{y}")
        label = tk.Label(self.tooltip_window, text=self.text, background="yellow")
        label.pack()
    def hide_tooltip(self, event=None):
        if self.tooltip_window:
            self.tooltip_window.destroy()
            self.tooltip_window = None
# ツールチップの追加
tooltip = ToolTip(combo, "ここを選択してください")

このコードでは、ToolTipクラスを作成し、コンボボックスにツールチップを追加しています。

マウスがコンボボックスに入るとツールチップが表示され、離れると非表示になります。

これらのカスタマイズを行うことで、コンボボックスをより使いやすく、魅力的なものにすることができます。

コンボボックスの応用例

コンボボックスは、さまざまなアプリケーションで活用できる便利なウィジェットです。

ここでは、コンボボックスを使った具体的な応用例をいくつか紹介します。

コンボボックスを使ったフォームの作成

コンボボックスを使用して、ユーザーからの入力を受け付けるフォームを作成できます。

以下のコードは、名前と性別を選択する簡単なフォームの例です。

import tkinter as tk
from tkinter import ttk
def submit_form():
    name = name_entry.get()
    gender = gender_combo.get()
    print(f"名前: {name}, 性別: {gender}")
root = tk.Tk()
root.title("フォームの例")
# 名前入力
tk.Label(root, text="名前:").pack(pady=5)
name_entry = tk.Entry(root)
name_entry.pack(pady=5)
# 性別選択
tk.Label(root, text="性別:").pack(pady=5)
gender_combo = ttk.Combobox(root, values=("男性", "女性", "その他"))
gender_combo.pack(pady=5)
gender_combo.current(0)  # 初期値を設定
# 送信ボタン
submit_button = tk.Button(root, text="送信", command=submit_form)
submit_button.pack(pady=20)
root.mainloop()

このフォームでは、ユーザーが名前を入力し、性別を選択して送信ボタンをクリックすると、選択された情報が表示されます。

コンボボックスを使ったフィルタリング機能の実装

コンボボックスを使用して、リストのフィルタリング機能を実装することもできます。

以下のコードは、選択したカテゴリに基づいて表示されるアイテムをフィルタリングする例です。

items = {
    "果物": ["リンゴ", "バナナ", "オレンジ"],
    "野菜": ["ニンジン", "トマト", "キュウリ"]
}
def update_items(event):
    selected_category = category_combo.get()
    item_combo['values'] = items[selected_category]
    item_combo.current(0)  # 初期値を設定
root = tk.Tk()
root.title("フィルタリング機能の例")
# カテゴリ選択
tk.Label(root, text="カテゴリ:").pack(pady=5)
category_combo = ttk.Combobox(root, values=list(items.keys()))
category_combo.pack(pady=5)
category_combo.current(0)  # 初期値を設定
category_combo.bind("<<ComboboxSelected>>", update_items)
# アイテム選択
tk.Label(root, text="アイテム:").pack(pady=5)
item_combo = ttk.Combobox(root)
item_combo.pack(pady=5)
update_items(None)  # 初期アイテムを設定
root.mainloop()

この例では、カテゴリを選択すると、それに応じたアイテムが表示されるようになっています。

コンボボックスを使った動的なUIの作成

コンボボックスを使用して、動的にUIを変更することも可能です。

以下のコードは、選択されたオプションに応じて異なるウィジェットを表示する例です。

def update_ui(event):
    selected_option = option_combo.get()
    if selected_option == "オプション1":
        label.config(text="オプション1が選ばれました")
        entry.pack(pady=5)
        entry.delete(0, tk.END)  # エントリーをクリア
    else:
        label.config(text="オプション2が選ばれました")
        entry.pack_forget()  # エントリーを非表示
root = tk.Tk()
root.title("動的UIの例")
# オプション選択
tk.Label(root, text="オプションを選択:").pack(pady=5)
option_combo = ttk.Combobox(root, values=("オプション1", "オプション2"))
option_combo.pack(pady=5)
option_combo.current(0)  # 初期値を設定
option_combo.bind("<<ComboboxSelected>>", update_ui)
# ラベルとエントリー
label = tk.Label(root, text="")
label.pack(pady=5)
entry = tk.Entry(root)
update_ui(None)  # 初期UIを設定
root.mainloop()

この例では、選択されたオプションに応じてラベルのテキストが変わり、エントリーウィジェットが表示または非表示になります。

これらの応用例を通じて、コンボボックスの柔軟性と利便性を活かしたインタラクティブなアプリケーションを作成することができます。