Python使用Tkinter GUI实现输入验证功能

目录

• 输入验证
• 1、Tkinter 验证简介
• 1.1 validate命令
• 1.2 validatecommand
• 1.3 invalidcommand
• 2、完整示例

输入验证

在本文中，将介绍如何使用 Tkinter 验证来验证用户输入。

1、Tkinter 验证简介

Tkinter 验证依赖于可用于任何输入小部件（例如 Entry 小部件）的三个选项：

• validate：指定哪种类型的事件将触发验证。
• validatecommand：检查数据是否有效
• invalidcommand：当数据无效时执行。 换句话说，如果 validate 命令返回 False，它将执行。

1.1 validate命令

validate 命令可以是以下字符串值之一：

1.2 validatecommand

validatecommand 是一个元组，包含：

• 对 Tcl/tk 函数的引用。
• 零个或多个替换代码指定触发要传递给函数的事件的信息。

要获取对 Tck/tk 函数的引用，请将可调用对象传递给 widget.register() 方法。 它返回一个可以与 validate 命令一起使用的字符串。

下表显示了可用于元组的替换代码：

以下示例构造一个使用 self.validate() 方法和 %P 替换代码的 validatecommand：

vcmd = (self.register(self.validate), '%P')

1.3 invalidcommand

与 validatecommand 一样，invalidcommand 也需要使用 widget.register() 方法和替换代码。

以下示例返回一个元组，您可以将其传递给 invalidcommand 选项：

ivcmd = (self.register(self.on_invalid),)

2、完整示例

下面将创建一个包含电子邮件输入的表单。 如果输入了无效的电子邮件地址，它将显示一条错误消息并将电子邮件输入的文本颜色更改为红色。 当焦点移出条目时，我们将触发验证事件。

import tkinter as tk
from tkinter import ttk
import re

class App(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title('Tkinter Validation Demo')
        self.create_widgets()
    def create_widgets(self):
        self.columnconfigure(0, weight=1)
        self.columnconfigure(1, weight=3)
        self.columnconfigure(2, weight=1)
        # label
        ttk.Label(text='Email:').grid(row=0, column=0, padx=5, pady=5)
        # email entry
        vcmd = (self.register(self.validate), '%P')
        ivcmd = (self.register(self.on_invalid),)
        self.email_entry = ttk.Entry(self, width=50)
        self.email_entry.config(validate='focusout', validatecommand=vcmd, invalidcommand=ivcmd)
        self.email_entry.grid(row=0, column=1, columnspan=2, padx=5)
        self.label_error = ttk.Label(self, foreground='red')
        self.label_error.grid(row=1, column=1, sticky=tk.W, padx=5)
        # button
        self.send_button = ttk.Button(text='Send').grid(row=0, column=4, padx=5)
    def show_message(self, error='', color='black'):
        self.label_error['text'] = error
        self.email_entry['foreground'] = color
    def validate(self, value):
        """
        Validat the email entry
        :param value:
        :return:
        pattern = r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b'
        if re.fullmatch(pattern, value) is None:
            return False
        self.show_message()
        return True
    def on_invalid(self):
        Show the error message if the data is not valid
        self.show_message('Please enter a valid email', 'red')
if __name__ == '__main__':
    app = App()
    app.mainloop()

示例代码如何工作？

第一步，使用 self.validate() 方法和 %P 替换代码创建一个验证命令：

vcmd = (self.register(self.validate), '%P')

第二步，创建使用 self.on_invalid 方法的 invalidatecommand：

ivcmd = (self.register(self.on_invalid),)

第三步，配置使用validation、validatecommand和invalidatecommand的Entry小部件：

self.email_entry.config(validate='focusout', validatecommand=vcmd, invalidcommand=ivcmd)

第四步，定义改变 label_error 小部件的文本和 email_entry 小部件的文本颜色的 show_message() 方法：

def show_message(self, error='', color='black'):
    self.label_error['text'] = error
    self.email_entry['foreground'] = color

第五步，定义验证 email_entry 值的 validate() 方法。

def validate(self, value):
    """
    Validat the email entry
    :param value:
    :return:
    """
    pattern = r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b'
    if re.fullmatch(pattern, value) is None:
        return False
    self.show_message()
    return True

如果输入文本有效，则 validate() 方法返回 True，否则返回 False。 如果输入文本是有效的电子邮件地址，请调用 show_message() 隐藏错误消息并将文本颜色设置为黑色。

如果输入文本不是有效的电子邮件地址，Tkinter 将执行 on_invalid() 方法。

最后，定义显示错误消息的 on_invalid() 方法并将 email_entry 小部件的文本颜色设置为红色。

def on_invalid(self):
    """
    Show the error message if the data is not valid
    :return:
    """
    self.show_message('Please enter a valid email', 'red')

到此这篇关于Python使用Tkinter GUI实现输入验证的文章就介绍到这了,更多相关Python Tkinter GUI输入验证内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！