The Tkinter Entry Widget
##简介
Entry(输入框)组件通常用于获取用户的输入文本。
##何时使用 Entry 组件?
Entry 组件仅允许用于输入一行文本,如果用于输入的字符串长度比该组件可显示空间更长,那内容将被滚动。这意味着该字符串将不能被全部看到(你可以用鼠标或键盘的方向键调整文本的可见范围)。
如果你希望接收多行文本的输入,可以使用 Text 组件(后面介绍)。
##用法
使用代码为 Entry 组件添加文本,可以使用 insert() 方法。如果要替换当前文本,可以先使用 delete() 方法,再使用 insert() 方法实现:
from tkinter import *
master = Tk()
e = 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 = StringVar()
e = Entry(master, textvariable=v)
e.pack()
v.set("老甲鱼")
s = v.get()
下边的例子演示将 Entry 组件和 Button 组件配合,点击 “获取信息” 按钮时自动清空输入框并将内容输出:
from tkinter import *
root = Tk()
Label(root,text="作品").grid(row=0,column=0)
Label(root,text="作者").grid(row=1,column=0)
e1 = Entry(root)
e2 = Entry(root)
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")
Button(root,text = "获取信息",width = 10,command = show)\
.grid(row = 3,column = 0,sticky = W,padx =10,pady =5)
Button(root,text = "退出", width = 10,command = root.quit)\
.grid(row = 3,column = 1,sticky = E,padx =10,pady =5)
mainloop()
(代码解析:首先就是先来两个Label标签,分别是作品和作者,然后,刚刚说了这次使用(网格)grid()来布局组件,grid的话他是允许用表格的形式来管理组件的位置,他的选项有row和column分别代表的是行和列,作品这个组件的位置就是在0行0列,作者的位置就是在0行0列,如上图的分布
接着是两个输入框,都是放在root窗口,再使用grid来布局,这两个输入框组件,上图可以看到,他们是位置分别就是0行1列和1行1列,然后再通过padx和pady设置一下内边距,好看一些
接着是要添加两个按钮,首先是第一个按钮是获取信息,然后给他设置一下宽度,在设置一个command选项,当按钮点下时就去执行show方法,那么show方法就是输入框对象e1和e2通过get方法获取到文本框的内容,然后输出,输出完后在用delete方法情况输入框,然后退出的按钮的command就设置root.quit就可以了,即调用根方法的quit方法,
接着就是把这两个按钮摆放好,即分别是2行0列和2行1列,但是要求一个按钮偏左边,一个靠右边,这里就需要设置一个sticky的属性,sticky就是控制组件在 grid 分配的空间中的位置,他的值和之前的anchor很相似,同样使用"n", “e”, “s”, “w” 以及它们的组合来定位(ewsn代表东西南北,上北下南左西右东),然后在设置一下padx和pady他就不会挨着墙角了)
※运行成功后点击退出是没反应的,退不来,因为我们使用的 IDLE 也是使用 tkinter 写出来的,他们这里会发生冲突,双击你源文件打开,用系统cmd窗口来运行就可以正常退出,如果想在IDLE可以退出,可以使用root.destroy
最后需要提到的是 Entry 组件允许通过以下几种方式指定字符的位置:
※数字索引号
※"anchoe"
※"end"
※"insert"
鼠标坐标("@x")
数字索引号:常规的 Python 索引号,从 0 开始
"anchor":对应第一个被选中的字符(如果有的话)
"end":对应已存在文本的后一个位置
"insert":对应插入光标的当前位置
鼠标坐标("@x"):x 是鼠标位置与 Entry 左侧边缘的水平距离,这样就可以通过鼠标相对地定位字符的位置
##参数
Entry(master=None, **options) (class)
master – 父组件
**options – 组件选项,下方表格详细列举了各个选项的具体含义和用法:
选项 | 含义 |
background | 1. 设置 Entry 的背景颜色 2. 默认值由系统指定 |
bg | 跟 background 一样 |
borderwidth | 1. 设置 Entry 的边框宽度 2. 默认值是 1 或 2 像素 |
bd | 跟 borderwidth 一样 |
cursor | 1. 指定当鼠标在 Entry 上飘过的时候的鼠标样式 2. 默认值由系统指定 |
exportselection | 1. 指定选中的文本是否可以被复制到剪贴板 2. 默认值是 True 3. 可以修改为 False 表示不允许复制文本 |
font | 1. 指定 Entry 中文本的字体 2. 默认值由系统指定 |
foreground | 1. 设置 Entry 的文本颜色 2. 默认值由系统指定 |
fg | 跟 foreground 一样 |
highlightbackground | 1. 指定当 Entry 没有获得焦点的时候高亮边框的颜色 2. 默认值由系统指定 |
highlightcolor | 1. 指定当 Entry 获得焦点的时候高亮边框的颜色 2. 默认值由系统指定 |
highlightthickness | 1. 指定高亮边框的宽度 2. 默认值是 1 或 2 像素 |
insertbackground | 指定输入光标的颜色 |
insertborderwidth | 1. 指定输入光标的边框宽度 2. 如果被设置为非 0 值,光标样式会被设置为 RAISED 3. 小甲鱼温馨提示:将 insertwidth 设置大一点才能看到效果哦 |
insertofftime | 1. 该选项控制光标的闪烁频率(灭) 2. 单位是毫秒 |
insertontime | 1. 该选项控制光标的闪烁频率(亮) 2. 单位是毫秒 |
insertwidth | 1. 指定光标的宽度 2. 默认值是 1 或 2 像素 |
invalidcommand | 1. 指定当输入框输入的内容“非法”时调用的函数 2. 也就是指定当 validateCommand 选项指定的函数返回 False 时的函数 3. 详见本内容最下方小甲鱼关于验证详解 |
invcmd | 跟 invalidcommand 一样 |
justify | 1. 定义如何对齐输入框中的文本 2. 使用 "left","right" 或 "center" 3. 默认值是 "left" |
relief | 1. 指定边框样式 2. 默认值是 "sunken" 3. 其他可以选择的值是 "flat","raised","groove" 和 "ridge" |
selectbackground | 1. 指定输入框的文本被选中时的背景颜色 2. 默认值由系统指定 |
selectborderwidth | 1. 指定输入框的文本被选中时的边框宽度(选中边框) 2. 默认值由系统指定 |
selectforeground | 1. 指定输入框的文本被选中时的字体颜色 2. 默认值由系统指定 |
show | 1. 设置输入框如何显示文本的内容 2. 如果该值非空,则输入框会显示指定字符串代替真正的内容 3. 将该选项设置为 "*",则是密码输入框 |
state | 1. Entry 组件可以设置的状态:"normal","disabled" 或 "readonly"(注意,它跟 "disabled" 相似,但它支持选中和拷贝,只是不能修改,而 "disabled" 是完全禁止) 2. 默认值是 "normal" 3. 注意,如果此选项设置为 "disabled" 或 "readonly",那么调用 insert() 和 delete() 方法都会被忽略 |
takefocus | 1. 指定使用 Tab 键可以将焦点移动到输入框中 2. 默认是开启的,可以将该选项设置为 False 避免焦点在此输入框中 |
textvariable | 1. 指定一个与输入框的内容相关联的 Tkinter 变量(通常是 StringVar) 2. 当输入框的内容发生改变时,该变量的值也会相应发生改变 |
validate | 1. 该选项设置是否启用内容验证 2. 详见本内容最下方小甲鱼关于验证详解 |
validatecommand | 1. 该选项指定一个验证函数,用于验证输入框内容是否合法 2. 验证函数需要返回 True 或 False 表示验证结果 3. 注意,该选项只有当 validate 的值非 "none" 时才有效 3. 详见本内容最下方小甲鱼关于验证详解 |
vcmd | 跟 validatecommand 一样 |
width | 1. 设置输入框的宽度,以字符为单位 2. 默认值是 20 3. 对于变宽字体来说,组件的实际宽度等于字体的平均宽度乘以 width 选项的值 |
xscrollcommand | 1. 与 scrollbar(滚动条)组件相关联 2. 如果你觉得用户输入的内容会超过该组件的输入框宽度,那么可以考虑设置该选项 3. 使用方法可以参考:Scrollbar 组件 |
##方法
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 是鼠标当前的水平位置),然后再将 事件绑定到 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 选项,该选项可以设置的值有:
值 | 含义 |
'focus' | 当 Entry 组件获得或失去焦点的时候验证 |
'focusin' | 当 Entry 组件获得焦点的时候验证 |
'focusout' | 当 Entry 组件失去焦点的时候验证 |
'key' | 当输入框被编辑的时候验证 |
'all' | 当出现上边任何一种情况的时候验证 |
'none' | 1. 关闭验证功能 2. 默认设置该选项(即不启用验证) 3. 注意,是字符串的 'none',而非 None |
上面是他可以设置的值有哪些,表示在什么情况下去验证,去调用验证函数,而验证函数是在validatecommand里边指定的,跟button里边的command选项是一样的道理,validatecommand函数只能返回 True 或 False 表示验证的结果。一般情况下验证函数只需要知道输入框的内容即可,可以通过 Entry 组件的 get() 方法获得该字符串。
下边的例子中,在第一个输入框输入“老甲鱼”,并通过 Tab 键将焦点转移到第二个输入框的时候,验证功能被成功触发:
from tkinter import *
master = Tk()
def test():
if e1.get() == "老甲鱼":
print("正确!")
return True
else:
print("错误!")
e1.delete(0, "end")
return False
v = StringVar()
e1 = Entry(master, textvariable=v, validate="focusout", validatecommand=test)
e2 = Entry(master)
e1.pack(padx=10, pady=10)
e2.pack(padx=10, pady=10)
master.mainloop()
然后,invalidcommand 选项指定的函数只有在 validatecommand 的返回值为 False 的时候才被调用。
下边的例子中,在第一个输入框输入“老甲鱼”,并通过 Tab 键将焦点转移到第二个输入框,validatecommand 指定的验证函数被触发并返回 False,接着 invalidcommand 被触发:
from tkinter import *
master = Tk()
def test():
if e1.get() == "老甲鱼":
print("正确!")
return True
else:
print("错误!")
e1.delete(0, "end")
return False
def test2():
print("我被调用了......")
return True
v = StringVar()
e1 = Entry(master, textvariable=v, validate="focusout",\
validatecommand=test, invalidcommand=test2)
e2 = Entry(master)
e1.pack(padx=10, pady=10)
e2.pack(padx=10, pady=10)
master.mainloop()
最后,其实 Tkinter 还有隐藏技能,不过需要冷却才能触发,请听老甲鱼一一道来…
Tkinter 为验证函数提供一些额外的选项:
Tkinter 为验证函数提供一些额外的选项:
额外选项 | 含义 |
'%d' | 操作代码:0 表示删除操作;1 表示插入操作;2 表示获得、失去焦点或 textvariable 变量的值被修改 |
'%i' | 1. 当用户尝试插入或删除操作的时候,该选线表示插入或删除的位置(索引号) 2. 如果是由于获得、失去焦点或 textvariable 变量的值被修改而调用验证函数,那么该值是 -1 |
'%P' | 1. 当输入框的值允许改变的时候,该值有效 2. 该值为输入框的最新文本内容 |
'%s' | 该值为调用验证函数前输入框的文本内容 |
'%S' | 1. 当插入或删除操作触发验证函数的时候,该值有效 2. 该选项表示文本被插入和删除的内容 |
'%v' | 该组件当前的 validate 选项的值 |
'%V' | 1. 调用验证函数的原因 2. 该值是 'focusin','focusout','key' 或 'forced'(textvariable 选项指定的变量值被修改)中的一个 |
'%W' | 该组件的名字,不过是 tk 变量在内部注册的名字,为一串数字。 |
为了使用这些选项,你可以这样写:validatecommand=(f, s1, s2, …)
其中,f 就是你“冷却后”的验证函数名,s1、s2、s3 这些就是上面表里额外的选项,这些选项会作为参数依次传给 f 函数。我们刚刚说了,使用隐藏技能前需要冷却,其实就是调用 register() 方法将验证函数包装起来:
(这个f也就是刚刚的上个例子validatecommand=test方法,在这里直接套进去不行,因为这样子Tkinter他不认,认不了你,所以需要先调用register() 方法将验证函数先包装起来,包装成Tkinter能够认出来的东西)
from tkinter import *
master = Tk()
v = StringVar()
def test(content, reason, name):
if content == "老甲鱼":
print("正确!")
print(content, reason, name)
return True
else:
print("错误!")
print(content, reason, name)
return False
testCMD = master.register(test)
e1 = Entry(master, textvariable=v, validate="focusout", validatecommand=(testCMD, '%P', '%v', '%W'))
e2 = Entry(master)
e1.pack(padx=10, pady=10)
e2.pack(padx=10, pady=10)
master.mainloop()
当我故意输入“小甲鱼”的时候,DUANG的一下,是错误的,后来我输入“老甲鱼”,嘿,又正确了:
(解析:对比上个例子可以发现,test方法不再是没有参数的方法了,他有三个参数,是在Entry组件的validatecommand选项中出现:validatecommand=(testCMD, ‘%P’, ‘%v’, ‘%W’),第一个%P查看上面的表可以知道是表示说他的值是输入框的最新文本内容,就是当输入框的值有改变的时候,%P就会有内容作为参数传到test方法的content参数,另外两个也是类似的道理,他们三个作为额外选项,作为参数传给test方法,然后%v就是表示该组件当前的 validate 选项的值,%W就是表示该组件的名字,在这里该组件就是e1,输出的就是e1在Tkinter里边注册的名字)
下一篇:Python —(七)Tkinter窗口组件:Listbox
转载博客:https://blog.csdn.net/w15977858408/article/details/104160155