亲宝软件园·资讯

展开

Python Tkinter GUI输入验证

视觉智能 人气:0

输入验证

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

1、Tkinter 验证简介

Tkinter 验证依赖于可用于任何输入小部件(例如 Entry 小部件)的三个选项:

1.1 validate命令

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

名称描述
‘focus’验证小部件何时获得或失去焦点
‘focusin’每当小部件获得焦点时进行验证
‘focusout’验证小部件何时失去焦点
‘key’每当任何击键更改小部件的内容时进行验证
‘all’在上述所有情况下验证聚焦、聚焦和关键
‘none’关闭验证。 默认设置

1.2 validatecommand

validatecommand 是一个元组,包含:

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

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

名称描述
%d'操作代码:0 表示尝试删除,1 表示尝试插入,或 -1 如果调用回调以聚焦、聚焦或更改“文本变量”
'%i'当用户试图插入或删除文本时,此参数将是插入或删除开始的索引。 如果回调是由于聚焦、聚焦或更改“textvariable”,则参数将为“-1”
'%P'如果允许更改,文本将具有的值
'%s'更改前Entry中的文本
'%S'如果调用是由于插入或删除,此参数将是被插入或删除的文本
'%v'小部件的 validate 选项的当前值
'%V'此回调的原因:如果 textvariable 被更改,则为 'focusin''focusout''key''forced' 之一
'%W'小部件的名称

以下示例构造一个使用 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),)

第三步,配置使用validationvalidatecommandinvalidatecommand的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')

加载全部内容

相关教程
猜你喜欢
用户评论