Tkinter 组件详解（七）：Entry_tkinter entry

Tkinter 组件详解之Entry

Entry（输入框）组件通常用于获取用户的输入文本。

何时使用 Entry 组件？

Entry 组件仅允许用于输入一行文本，如果用于输入的字符串长度比该组件可显示空间更长，那内容将被滚动。这意味着该字符串将不能被全部看到（你可以用鼠标或键盘的方向键调整文本的可见范围）。

如果你希望接收多行文本的输入，可以使用 Text 组件（后面介绍）。

用法

使用代码为 Entry 组件添加文本，可以使用 insert() 方法。如果要替换当前文本，可以先使用 delete() 方法，再使用 insert() 方法实现：

import tkinter as tk
 
master = tk.Tk()
 
e = tk.Entry(master)
e.pack(padx=20, pady=20)
 
e.delete(0, "end")
e.insert(0, "默认文本...")
 
master.mainloop()

获取当前输入框的文本，可以使用 get() 方法：

s = e.get()

你也可以绑定 Entry 组件到 Tkinter 变量（StringVar），并通过该变量设置和获取输入框的文本：

v = tk.StringVar()
e = tk.Entry(master, textvariable=v)
e.pack()
 
v.set("I love Python!")
s = v.get()

下边的例子演示将 Entry 组件和 Button 组件配合，点击 “获取信息” 按钮时自动清空输入框并将内容输出：

import tkinter as tk
 
master = tk.Tk()
 
tk.Label(master, text="作品：").grid(row=0)
tk.Label(master, text="作者：").grid(row=1)
 
e1 = tk.Entry(master)
e2 = tk.Entry(master)
e1.grid(row=0, column=1, padx=10, pady=5)
e2.grid(row=1, column=1, padx=10, pady=5)
 
def show():
    print("作品：《%s》" % e1.get())
    print("作者：%s" % e2.get())
    e1.delete(0, "end")
    e2.delete(0, "end")
 
tk.Button(master, text="获取信息", width=10, command=show).grid(row=3, column=0, sticky="w", padx=10, pady=5)
tk.Button(master, text="退出", width=10, command=master.quit).grid(row=3, column=1, sticky="e", padx=10, pady=5)
 
master.mainloop()

最后需要提到的是 Entry 组件允许通过以下几种方式指定字符的位置：

• 数字索引号
• "anchoe"
• "end"
• "insert"
• 鼠标坐标（"@x"）

数字索引号：常规的 Python 索引号，从 0 开始

"anchor"：对应第一个被选中的字符（如果有的话）

"end"：对应已存在文本的后一个位置

"insert"：对应插入光标的当前位置

鼠标坐标（"@x"）：x 是鼠标位置与 Entry 左侧边缘的水平距离，这样就可以通过鼠标相对地定位字符的位置

参数

Entry(master=None, **options) (class)

master -- 父组件

**options -- 组件选项，下方表格详细列举了各个选项的具体含义和用法：

方法

delete(first, last=None) 

-- 删除参数 first 到 last 范围内（包含 first 和 last）的所有内容
-- 如果忽略 last 参数，表示删除 first 参数指定的选项
-- 使用 delete(0, END) 实现删除输入框的所有内容

get()

-- 获得当前输入框的内容

icursor(index)

-- 将光标移动到 index 参数指定的位置
-- 这同时也会设置 INSERT 的值

index(index) 

-- 返回与 index 参数相应的选项的序号（例如 e.index(END)）

insert(index, text) 

-- 将 text 参数的内容插入到 index 参数指定的位置
-- 使用 insert(INSERT, text) 将 text 参数指定的字符串插入到光标的位置
-- 使用 insert(END, text) 将 text 参数指定的字符串插入到输入框的末尾

scan_dragto(x) 

--  见下方 scan_mark(x)

scan_mark(x)

-- 使用这种方式来实现输入框内容的滚动
-- 需要将鼠标按下事件绑定到 scan_mark(x) 方法（x 是鼠标当前的水平位置），然后再将 <motion> 事件绑定到 scan_dragto(x) 方法（x 是鼠标当前的水平位置），就可以实现输入框在当前位置和 sacn_mack(x) 指定位置之间的水平滚动

select_adjust(index)
-- 与 selection_adjust(index) 相同，见下方解释

select_clear()
-- 与 selection_clear() 相同，见下方解释

select_from(index)
-- 与 selection_from(index) 相同，见下方解释

select_present()
-- 与 selection_present() 相同，见下方解释

select_range(start, end)
-- 与 selection_range(start, end) 相同，见下方解释

select_to(index)
-- 与 selection_to(index) 相同，见下方解释

selection_adjust(index)
-- 该方法是为了确保输入框中选中的范围包含 index 参数所指定的字符
-- 如果选中的范围已经包含了该字符，那么什么事情也不会发生
-- 如果选中的范围不包含该字符，那么会从光标的位置将选中的范围扩展至该字符

selection_clear()
-- 取消选中状态

selection_from(index)
-- 开始一个新的选中范围
-- 会设置 ANCHOR 的值

selection_present()
-- 返回输入框是否有处于选中状态的文本
-- 如果有则返回 True，否则返回 False

selection_range(start, end)
-- 设置选中范围
-- start 参数必须必 end 参数小
-- 使用 selection_range(0, END) 选中整个输入框的所有内容

selection_to(index)
-- 选中 ANCHOR 到 index 参数的间的所有内容

xview(index)
-- 该方法用于确保给定的 index 参数所指定的字符可见
-- 如有必要，会滚动输入框的内容

xview_moveto(fraction)
-- 根据 fraction 参数给定的比率调整输入框内容的可见范围
-- fraction 参数的范围是 0.0 ~ 1.0，0.0 表示输入框的开始位置，1.0 表示输入框的结束位置

xview_scroll(number, what)
-- 根据给定的参数水平滚动输入框的可见范围
-- number 参数指定滚动的数量，如果是负数则表示反向滚动
-- what 参数指定滚动的单位，可以是 UNITS 或 PAGES（UNITS 表示一个字符单元，PAGES 表示一页）

关于验证详解

由于查看了不少资料，很多在这里都没有解释清楚，所以这里单独列出来详细讲解下。

Entry 组件是支持验证输入内容的合法性的，比如要求输入数字，你输入了字母那就是非法。实现该功能，需要通过设置 validate、validatecommand 和 invalidcommand 选项。

首先启用验证的“开关”是 validate 选项，该选项可以设置的值有：

其次是为 validatecommand 选项指定一个验证函数，该函数只能返回 True 或 False 表示验证的结果。一般情况下验证函数只需要知道输入框的内容即可，可以通过 Entry 组件的 get() 方法获得该字符串。

下边的例子中，在第一个输入框输入“CSDN” 并通过 Tab 键或者鼠标将焦点转移到第二个输入框的时候，验证功能被成功触发：

import tkinter as tk
 
master = tk.Tk()
 
def test():
    if e1.get() == "CSDN":
        print("正确！")
        return True
    else:
        print("错误！")
        e1.delete(0, "end")
        return False
 
v = tk.StringVar()
 
e1 = tk.Entry(master, textvariable=v, validate="focusout", validatecommand=test)
e2 = tk.Entry(master)
e1.pack(padx=10, pady=10)
e2.pack(padx=10, pady=10)
 
master.mainloop()

然后，invalidcommand 选项指定的函数只有在 validatecommand 的返回值为 False 的时候才被调用。

下边的例子中，在第一个输入框输入“csdn”，并通过 Tab 键将焦点转移到第二个输入框，validatecommand 指定的验证函数被触发并返回 False，接着 invalidcommand 被触发：

import tkinter as tk
 
master = tk.Tk()
 
def test():
    if e1.get() == "CSDN":
        print("正确！")
        return True
    else:
        print("错误！")
        e1.delete(0, "end")
        return False
 
def test2():
    print("我被调用了......")
    return True
 
v = tk.StringVar()
 
e1 = tk.Entry(master, textvariable=v, validate="focusout", validatecommand=test, invalidcommand=test2)
e2 = tk.Entry(master)
e1.pack(padx=10, pady=10)
e2.pack(padx=10, pady=10)
 
master.mainloop()

最后，其实 Tkinter 还有隐藏技能，不过需要冷却才能触发，请听我一一道来......

Tkinter 为验证函数提供一些额外的选项：

为了使用这些选项，你可以这样写：validatecommand=(f, s1, s2, ...)

其中，f 就是你“冷却后”的验证函数名，s1、s2、s3 这些是额外的选项，这些选项会作为参数依次传给 f 函数。我们刚刚说了，使用隐藏技能前需要冷却，其实就是调用 register() 方法将验证函数包装起来：

import tkinter as tk
 
master = tk.Tk()
 
v = tk.StringVar()
 
def test(content, reason, name):
    if content == "CSDN":
        print("正确！")
        print(content, reason, name)
        return True
    else:
        print("错误！")
        print(content, reason, name)
        return False
 
testCMD = master.register(test)
e1 = tk.Entry(master, textvariable=v, validate="focusout", validatecommand=(testCMD, '%P', '%v', '%W'))
e2 = tk.Entry(master)
e1.pack(padx=10, pady=10)
e2.pack(padx=10, pady=10)
 
master.mainloop()

当我故意输入“CSDN我爱你”的时候，DUANG的一下，是错误的，后来我果断删除了“我爱你”，嘿，又正确了：