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的一下，是错误的，后来我果断删除了“我爱你”，嘿，又正确了：

 到此这篇关于Tkinter组件Entry的具体使用的文章就介绍到这了,更多相关Tkinter Entry内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持！