GUI

[Python Tkinter] Entry(テキストボックス)を数字のみ入力できるようにする方法

2025-01-18更新日: 2025-01-18

PythonのTkinterでEntryウィジェットに数字のみを入力できるようにするには、validateオプションとvalidatecommandオプションを使用します。

validateには'key'を指定し、validatecommandには入力が行われるたびに呼び出される関数を指定します。

この関数内で、入力が数字かどうかをチェックします。

例えば、str.isdigit()を使って入力が数字かどうかを確認し、数字以外の入力を無効にすることができます。

目次から探す

Entryウィジェットで数字のみを入力させる方法
実装例：数字のみ入力可能なEntryウィジェット
応用例：Entryウィジェットで特定の形式の入力を制限する
まとめ

Entryウィジェットで数字のみを入力させる方法

PythonのTkinterライブラリを使用すると、GUIアプリケーションを簡単に作成できます。

その中でも、Entryウィジェットはユーザーからの入力を受け取るための重要な要素です。

ここでは、Entryウィジェットに数字のみを入力させる方法について詳しく解説します。

validateオプションとvalidatecommandオプションの概要

Entryウィジェットには、入力内容を検証するためのvalidateオプションとvalidatecommandオプションがあります。

これらを使用することで、ユーザーが入力した内容をリアルタイムでチェックし、特定の条件を満たさない場合は入力を拒否することができます。

オプション名	説明
validate	入力検証のタイミングを指定するオプション。`key`、`focus`、`all`などが指定可能。
validatecommand	検証を行うための関数を指定するオプション。関数がTrueを返すと入力が許可される。

validate=’key’の意味

validate='key'を指定すると、ユーザーがキーを押したときに入力検証が行われます。

これにより、リアルタイムで入力内容をチェックし、条件に合わない場合は入力を無効にすることができます。

validatecommandで関数を指定する方法

validatecommandオプションには、入力検証を行う関数を指定します。

この関数は、入力が行われるたびに呼び出され、戻り値がTrueまたはFalseである必要があります。

Trueを返すと入力が許可され、Falseを返すと入力が拒否されます。

import tkinter as tk
def validate_input(new_value):
    return new_value.isdigit()  # 数字のみ許可
root = tk.Tk()
vcmd = (root.register(validate_input), '%P')  # %Pは新しい入力値を表す
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
root.mainloop()

出力結果は特にありませんが、数字以外の入力は無効になります。

入力が数字かどうかを確認する方法

ユーザーが入力した内容が数字かどうかを確認する方法はいくつかあります。

ここでは、str.isdigit()メソッドと正規表現を使った方法を紹介します。

str.isdigit()を使った数字判定

str.isdigit()メソッドを使用すると、文字列が数字のみで構成されているかを簡単に判定できます。

このメソッドは、全ての文字が数字であればTrueを返します。

def validate_input(new_value):
    return new_value.isdigit()  # 数字のみ許可

正規表現を使った数字判定

正規表現を使用することで、より柔軟な入力検証が可能です。

例えば、整数や小数、負の数など、特定の形式を許可することができます。

import re
def validate_input(new_value):
    return bool(re.match(r'^\d+$', new_value))  # 整数のみ許可

Entryウィジェットにバインドする方法

Entryウィジェットにバインドすることで、特定のイベントに対して関数を実行することができます。

例えば、ユーザーが入力を行った際に自動的に検証を行うことができます。

entry.bind('<KeyRelease>', lambda event: validate_input(entry.get()))

このように、TkinterのEntryウィジェットを使用することで、ユーザーからの入力を制限し、アプリケーションの信頼性を向上させることができます。

実装例：数字のみ入力可能なEntryウィジェット

ここでは、Tkinterを使用して数字のみを入力可能なEntryウィジェットの実装例を紹介します。

基本的な実装から、エラーメッセージの表示、小数点や負の数を許可する方法までを解説します。

基本的な実装例

まずは、基本的な数字のみを入力可能なEntryウィジェットの実装例を見てみましょう。

import tkinter as tk
def validate_input(new_value):
    return new_value.isdigit()  # 数字のみ許可
root = tk.Tk()
vcmd = (root.register(validate_input), '%P')  # %Pは新しい入力値を表す
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
root.mainloop()

このコードを実行すると、Entryウィジェットには数字のみが入力可能になります。

数字以外の入力は無効になります。

エラーメッセージを表示する方法

ユーザーが無効な入力を行った場合にエラーメッセージを表示する方法を見てみましょう。

以下のコードでは、無効な入力が行われた際にラベルにエラーメッセージを表示します。

import tkinter as tk
def validate_input(new_value):
    if new_value.isdigit():
        error_label.config(text="")  # エラーメッセージを消去
        return True
    else:
        error_label.config(text="数字のみ入力可能です。")  # エラーメッセージを表示
        return False
root = tk.Tk()
vcmd = (root.register(validate_input), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

この実装では、無効な入力が行われると、赤色のエラーメッセージが表示されます。

小数点や負の数を許可する方法

次に、小数点や負の数を許可する方法を見ていきます。

これには、入力検証のロジックを少し変更する必要があります。

小数点を許可する実装

小数点を許可するためには、正規表現を使用して小数点を含む数値を検証します。

import tkinter as tk
import re
def validate_input(new_value):
    if re.match(r'^-?\d*\.?\d*$', new_value):  # 整数または小数を許可
        error_label.config(text="")
        return True
    else:
        error_label.config(text="数字または小数点を入力してください。")
        return False
root = tk.Tk()
vcmd = (root.register(validate_input), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

このコードでは、負の数や小数点を含む数値が入力可能になります。

負の数を許可する実装

負の数を許可する場合も、同様に正規表現を使用します。

上記の実装で既に負の数を許可していますが、改めて確認してみましょう。

import tkinter as tk
import re
def validate_input(new_value):
    if re.match(r'^-?\d*\.?\d*$', new_value):  # 整数または小数を許可
        error_label.config(text="")
        return True
    else:
        error_label.config(text="数字または小数点を入力してください。")
        return False
root = tk.Tk()
vcmd = (root.register(validate_input), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

この実装により、ユーザーは負の数や小数点を含む数値を入力できるようになります。

エラーメッセージも適切に表示されるため、ユーザーにとって使いやすいインターフェースが実現できます。

応用例：Entryウィジェットで特定の形式の入力を制限する

TkinterのEntryウィジェットを使用して、特定の形式の入力を制限する方法を紹介します。

ここでは、電話番号、郵便番号、日付の入力制限の実装例と、カスタムバリデーション関数の作成方法について解説します。

電話番号の入力を制限する

日本の電話番号の形式に合わせて、数字とハイフンを許可する入力制限を実装します。

以下のコードでは、電話番号の形式(例：090-1234-5678)を検証します。

import tkinter as tk
import re
def validate_phone_number(new_value):
    if re.match(r'^\d{2,4}-\d{2,4}-\d{4}$|^\d{10,11}$', new_value):  # 電話番号の形式を許可
        error_label.config(text="")
        return True
    else:
        error_label.config(text="電話番号は `090-1234-5678` の形式で入力してください。")
        return False
root = tk.Tk()
vcmd = (root.register(validate_phone_number), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

この実装により、ユーザーは正しい形式の電話番号のみを入力できるようになります。

郵便番号の入力を制限する

日本の郵便番号(例：123-4567)の形式を検証するための実装例です。

ハイフンを含む7桁の数字を許可します。

import tkinter as tk
import re
def validate_postal_code(new_value):
    if re.match(r'^\d{3}-\d{4}$', new_value):  # 郵便番号の形式を許可
        error_label.config(text="")
        return True
    else:
        error_label.config(text="郵便番号は `123-4567` の形式で入力してください。")
        return False
root = tk.Tk()
vcmd = (root.register(validate_postal_code), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

このコードを実行すると、郵便番号の形式が正しい場合のみ入力が許可されます。

日付の入力を制限する

日付の入力を制限するために、YYYY-MM-DD形式(例：2023-10-01)を検証する実装例です。

import tkinter as tk
import re
def validate_date(new_value):
    if re.match(r'^\d{4}-\d{2}-\d{2}$', new_value):  # 日付の形式を許可
        error_label.config(text="")
        return True
    else:
        error_label.config(text="日付は `YYYY-MM-DD` の形式で入力してください。")
        return False
root = tk.Tk()
vcmd = (root.register(validate_date), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

この実装により、ユーザーは正しい形式の日付のみを入力できるようになります。

カスタムバリデーション関数を作成する

特定の条件に基づいて入力を検証するカスタムバリデーション関数を作成することも可能です。

以下の例では、特定の文字列を含むかどうかを検証します。

import tkinter as tk
def validate_custom_input(new_value):
    if "特定の文字列" in new_value:  # 特定の文字列を含むか検証
        error_label.config(text="")
        return True
    else:
        error_label.config(text="入力には「特定の文字列」を含めてください。")
        return False
root = tk.Tk()
vcmd = (root.register(validate_custom_input), '%P')
entry = tk.Entry(root, validate='key', validatecommand=vcmd)
entry.pack()
error_label = tk.Label(root, text="", fg="red")
error_label.pack()
root.mainloop()

このカスタムバリデーション関数を使用することで、特定の条件に基づいた入力制限が可能になります。

ユーザーが指定された条件を満たさない場合、エラーメッセージが表示されます。

これにより、より柔軟な入力制限が実現できます。