![4a4cf65746960163be60da8aa9f1aac2.png](https://i-blog.csdnimg.cn/blog_migrate/e85ec61b65dfa5ec38bb1777f5e21bfe.jpeg)
一、组件简介
Text 组件,文本框,一个非常灵活而又强大的组件,主要用于显示和处理多行文本。
Text 组件用于显示文本文档,包含纯文本或格式化文本,比如使用不同字体、嵌入图片、显示链接,甚至是带 CSS 格式的 HTML 等等。
Label 组件虽然可以跨多行显示,但是只能显示单一字体;而使用 Text,你可以实现各种花里胡哨的样式。
二、运用实例
1. Text 多样式文本
我们在最前面说到,Text 组件相对 Label 组件最大的优势就是显示各种各样的样式的文本。
import tkinter as tk
root = tk.Tk()
text = tk.Text(root, width=20, height=5)
text.pack(padx=10, pady=10)
# 设置文本格式tag
text.tag_config('tag_1', background='yellow', foreground='red') # bg,fg 并不是它的缩写
# insert 索引表示插入光标的当前位置,并可以设置文本格式
text.insert('insert', '我今天想吃') # 在光标位置插入
text.insert('end','麻辣小龙虾', 'tag_1') # 在最后位置插入
root.mainloop()
运行程序,显示如下:
![b72303de25ac571ea0f39fbc7adb09f0.png](https://i-blog.csdnimg.cn/blog_migrate/85ee678be0922701b50d8fefc0a53089.png)
利用tag_config()
方法,我们可以自定义各式各样的文本格式,最后在insert()
最后添加自定义命名的tag参数,从而就实现对指定文本使用特定格式的操作。
2. Text 中插入对象
在 Text 组件中可以插入其他对象,使用 window_create()
方法插入其他组件,使用 image_create()
方法插入图片。
import tkinter as tk
root = tk.Tk()
text = tk.Text(root, width=50, height=20)
text.pack(padx=10, pady=10)
# 设置文本格式tag
text.tag_config('tag_1', background='yellow', foreground='red') # bg,fg 并不是它的缩写
# insert 索引表示插入光标的当前位置,并可以设置文本格式
text.insert('insert', '我今天想吃') # 在光标位置插入
text.insert('end','麻辣小龙虾', 'tag_1') # 在最后位置插入
text.insert('end','n') # 实现换行
def callback():
print("啊~有点痛!!!")
# 插入按钮
bt = tk.Button(text, text="轻轻点", command=callback)
text.window_create('insert', window=bt)
text.insert('end','n') # 实现换行
# 插入图片
photo = tk.PhotoImage(file='头像2.png')
text.image_create('insert', image=photo)
root.mainloop()
![ceaf1cc832349a2078a2966bbfa53e2e.png](https://i-blog.csdnimg.cn/blog_migrate/a1ee8af6dfbbc6e01a022b108710b682.jpeg)
三、参数方法
1. 参数汇总
归纳总结Text组件中一些常用的参数以及用法。
![81f9867305b531ab746e85a190f43684.png](https://i-blog.csdnimg.cn/blog_migrate/7810ab20ab63adb0eeb19fc8af2118c6.jpeg)
2. 方法汇总
bbox(index)
- 返回给定索引指定的字符的边界框
- 返回值是一个 4 元组:(x, y, width, height)
- 如果该字符是不可见的,那么返回 None
- 注意:只有当 Text 组件被更新的时候该方法才有效,可以使用 update_idletasks() 方法先更新 Text 组件
compare(index1, op, index2)
- 返回对比 index1 和 index2 指定的两个字符的结果
- op 是操作符:’<’, ‘<=’, ‘==’, ‘>=’, ‘>’ 或 ‘!=’(不支持 Python 的 ‘<>’ 操作符)
- 返回布尔类型的值表示对比的结果
debug(boolean=None)
- 开启或关闭 Debug 状态
delete(start, end=None)
- 删除给定范围的文本或嵌入对象
- 如果在给定范围内有任何 Marks 标记的位置,则将 Marks 移动到 start 参数开始的位置
dlineinfo(index)
- 返回给定索引指定的字符所在行的边界框
- 返回值是一个 5 元组:(x, y, width, height, offset),offset 表示从该行的顶端到基线的偏移
- 如果该行不可见,则返回 None
- 注意:只有当 Text 组件被更新的时候该方法才有效,可以使用 update_idletasks() 方法先更新 Text 组件
dump(index1, index2=None, command=None, **kw)
- 返回 index1 和 index2 之间的内容
- 返回的值是一个由 3 元组(关键词,值,索引)组成的列表,关键词参数的顺序为:all, image, mark, tag, text, window
- 默认关键词是 ‘all’,表示全部关键词均为选中状态
- 如果需要筛选个别关键词,可以用 dump(index1, index2, image=True, text=True) 这样的形式调用
- 如果指定了 command 函数,那么会为列表中的每一个三元组作为参数调用一次该函数(这种情况下,dump() 不返回值)
edit_modified(arg=None)
- 该方法用于查询和设置 modified 标志(该标标志用于追踪 Text 组件的内容是否发生变化)
- 如果不指定 arg 参数,那么返回 modified 标志是否被设置
- 你可以传递显式地使用 True 或 False 作为参数来设置或清除 modified 标志
- 任何代码或用户的插入或删除文本操作,“撤销”或“恢复”操作,都会是的 modified 标志被设置
edit_redo(self)
- “恢复”上一次的“撤销”操作
- 如果 undo 选项为 False,该方法无效
- 详见上方用法【“撤销”和“恢复”操作】
edit_reset()
- 清空存放操作记录的栈
edit_separator()
- 插入一个“分隔符”到存放操作记录的栈中,用于表示已经完成一次完整的操作
- 如果 undo 选项为 False,该方法无效
- 详见上方用法【“撤销”和“恢复”操作】
edit_undo()
- 撤销最近一次操作
- 如果 undo 选项为 False,该方法无效
- 详见上方用法【“撤销”和“恢复”操作】
get(index1, index2=None)
- 返回 index1 到 index2(不包含)之间的文本
- 如果 index2 参数忽略,则返回一个字符
- 如果包含 image 和 window 的嵌入对象,均被忽略
- 如果包含有多行文本,那么自动插入换行符(’n’)
image_cget(index, option)
- 返回 index 参数指定的嵌入 image 对象的 option 选项的值
- 如果给定的位置没有嵌入 image 对象,则抛出 TclError 异常
image_configure(index, **options)
- 修改 index 参数指定的嵌入 image 对象的一个或多个 option 选项的值
- 如果给定的位置没有嵌入 image 对象,则抛出 TclError 异常
image_create(index, cnf={}, **kw)
- 在 index 参数指定的位置嵌入一个 image 对象
- 该 image 对象必须是 Tkinter 的 PhotoImage 或 BitmapImage 实例
- 可选选项 align:设定此图像的垂直对齐,可以是 TOP、CENTER、BOTTOM 或 BASELINE
- 可选选项 image:PhotoImage 或 BitmapImage 对象
- 可选选项 name:你可以为该图像实例命名,如果你忽略此选项,那么 Tkinter 会自动为其取一个独一无二的名字。
- 可选选项 padx:设置水平方向上的额外间距
- 可选选项 pady:设置垂直方向上的额外间距
image_names()
- 返回 Text 组件中嵌入的所有 image 对象的名字
index(index)
- 将 index 参数指定的位置以 “line.column” 的索引形式返回
- index 参数支持任何格式的索引
insert(index, text, *tags)
- 在 index 参数指定的位置插入字符串
- 可选参数 tags 用于指定文本的样式
- 详见上方【Tags 用法】
mark_gravity(self, markName, direction=None)
- 设置 Mark 的方向,可以是 LEFT 或 RIGHT(默认是 RIGHT,即如果在 Mark 处插入文本的话,Mark 将发生相应的移动以保持在插入文本的右侧)
- 如果设置为 LEFT,那么在 Mark 处插入文本并不会移动 Mark(因为 Mark 在插入文本的左侧)
- 如果忽略 direction 参数,则返回指定 Mark 的方向
- 详见上方【Marks 用法】
mark_names()
- 返回 Text 组件中所有 Marks 的名字
- 包括两个特殊 Mark:INSERT 和 CURRENT
- 注意:END 是特殊的索引,不是 Mark
mark_next(index)
- 返回在 index 指定的位置后边的一个 Mark 的名字
- 如果不存在则返回空字符串
mark_previous(index)
- 返回在 index 指定的位置前边的一个 Mark 的名字
- 如果不存在则返回空字符串
mark_set(markName, index)
- 移动 Mark 到 index 参数指定的位置
- 如果 markName 参数指定的 Mark 不存在,则创建一个新的 Mark
mark_unset(*markNames)
- 删除 markNames 指定的 Marks
- 不能删除预定义的 INSERT 和 CURRENT
replace(index1, index2, chars, *args)
- 将 index1 到 index2 之间的内容替换为 chars 参数指定的字符串
- 如果需要为替换的内容添加 Tag,可以在 args 参数指定 Tag
- 详见上方【Tags 用法】
scan_dragto(x, y)
- 详见下方 scan_mark(x, y)
scan_mark(x, y)
- 使用这种方式来实现 Text 组件内容的滚动
- 需要将鼠标按钮事件以及鼠标当前位置绑定到 scan_mark(x, y) 方法,然后将 事件及当前鼠标位置绑定到 scan_dragto(x, y) 方法,就可以实现 Text 组件的内容在当前位置和 scan_mark(x, y) 指定的位置 (x, y) 之间滚动
search(pattern, index, stopindex=None, forwards=None, backwards=None, exact=None, regexp=None, nocase=None, count=None)
- 从 index 开始搜索 pattern,到 stopindex 结束(不指定表示搜索到末尾)
- 如果成功找到,以 “line.column” 返回第一个匹配的字符;否则返回空字符串
- forwards 参数设置为 True 表示向前(->)搜索
- backwards 参数设置为 True 表示向后(<-)搜索
- exact 参数设置为 True 表示搜索与 pattern 完全匹配的结果
- regexp 参数设置为 True,则 pattern 被解释为 Tcl 格式的正则表达式
- nocase 参数设置为 True 是忽略大小写,默认是区分大小写的搜索
- count 参数指定为一个 IntVar 的 Tkinter 变量,用于存放当找到匹配的字符个数(如果匹配结果中没有嵌入的 image 或 window 对象的话,一般该值等于 pattern 的字符个数)
see(index)
- 滚动内容,确保 index 指定的位置可见
tag_add(tagName, index1, index2=None)
- 为 index1 到 index2 之间的内容添加一个 Tag(tagName 参数指定)
- 如果 index2 参数忽略,则单独为 index1 指定的内容添加 Tag
- 详见上方【Tags 用法】
tag_bind(tagName, sequence, func, add=None)
- 为 Tag 绑定事件
- 详见上方【Tags 用法】
tag_cget(tagName, option)
- 返回 tagName 指定的 option 选项的值
tag_config(tagName, cnf=None, **kw)
- 跟 tag_configure(tagName, cnf=None, **kw) 一样
tag_configure(tagName, cnf=None, **kw)
- 设置 tagName 的选项
- 详见上方【Tags 用法】
tag_delete(*tagNames)
- 删除 tagNames 指定的 Tags
tag_lower(tagName, belowThis=None)
- 降低 Tag 的优先级
- 如果 belowThis 参数不为空,则表示 tagName 需要比 belowThis 指定的 Tag 优先级更低
详见上方【Tags 用法】
tag_names(index=None)
- 如果不带参数,表示返回 Text 组件中所有 Tags 的名字
- index 参数表示返回该位置上所有的 Tags 的名字
tag_nextrange(tagName, index1, index2=None)
- 在 index1 到 index2 的范围内第一个 tagName 的位置
- 如果没有则返回空字符串
tag_prevrange(tagName, index1, index2=None)
- tag_nextrange() 的反向查找,也就是查找范围是 index2 到 index1
tag_raise(tagName, aboveThis=None)
- 提高 Tag 的优先级
- 如果 aboveThis 参数不为空,则表示 tagName 需要比 aboveThis 指定的 Tag 优先级更高详见上方【Tags 用法】
tag_ranges(tagName)
- 返回所有 tagName 指定的文本,并将它们的范围以列表的形式返回
tag_remove(tagName, index1, index2=None)
- 删除 index1 到 index2 之间所有的 tagName
- 如果忽略 index2 参数,那么只删除 index1 指定的那个字符的 tagName(如果有的话)
tag_unbind(tagName, sequence, funcid=None)
- 解除与 tagName 绑定的事件(sequence 指定)
window_cget(index, option)
- 返回 index 参数指定的嵌入 window 对象的 option 选项的值
- 如果给定的位置没有嵌入 window 对象,则抛出 TclError 异常
window_config(index, cnf=None, **kw)
- 跟 window_configure(index, cnf=None, **kw) 一样
window_configure(index, cnf=None, **kw)
- 修改 index 参数指定的嵌入 window 对象的一个或多个 option 选项的值
- 如果给定的位置没有嵌入 window 对象,则抛出 TclError 异常
window_create(index, **options)
- 在 index 参数指定的位置嵌入一个 window 对象
- 支持两种方式在 Text 组件中嵌入 window 对象:请看下方 create 选项和 window 选项的描述
- 可选选项 align:设定此图像的垂直对齐,可以是 TOP、CENTER、BOTTOM 或 BASELINE
- 可选选项 create:指定一个回调函数用于创建嵌入的 window 组件,该函数没有参数,并且必须创建 Text 的子组件并返回
- 可选选项 padx:设置水平方向上的额外间距
- 可选选项 pady:设置垂直方向上的额外间距
- 可选选项 stretch:该选项控制当行的高度大于嵌入组件的高度时,嵌入组件是否延伸。默认值是 False,表示组件保持原形;设置为 True 表示将该组件垂直部分延伸至行的高度
- 可选选项 window:指定一个已经创建好的 window 组件,该组件必须是 Text 组件的子组件
window_names()
- 返回 Text 组件中嵌入的所有 window 对象的名字
xview(*args)
- 该方法用于在水平方向上滚动 Text 组件的内容,一般通过绑定 Scollbar 组件的 command 选项来实现(具体操作参考:Scrollbar)
- 如果第一个参数是 MOVETO,则第二个参数表示滚动到指定的位置:0.0 表示最左端,1.0 表示最右端
- 如果第一个参数是 SCROLL,则第二个参数表示滚动的数量,第三个参数表示滚动的单位(可以是 UNITS 或 PAGES),例如:xview(SCROLL, 3, UNITS) 表示向右滚动三行
xview_moveto(fraction)
- 跟 xview(MOVETO, fraction) 一样
- xview_scroll(number, what)
- 跟 xview(SCROLL, number, what) 一样
yview(*args)
- 该方法用于在垂直方向上滚动 Text 组件的内容,一般通过绑定 Scollbar 组件的 command 选项来实现(具体操作参考:Scrollbar)
- 如果第一个参数是 MOVETO,则第二个参数表示滚动到指定的位置:0.0 表示最顶端,1.0 表示最底端
- 如果第一个参数是 SCROLL,则第二个参数表示滚动的数量,第三个参数表示滚动的单位(可以是 UNITS 或 PAGES),例如:yview(SCROLL, 3, PAGES) 表示向下滚动三页
yview_moveto(fraction)
- 跟 yview(MOVETO, fraction) 一样
yview_scroll(number, what)
- 跟 yview(SCROLL, number, what) 一样
赠人玫瑰,手留余香。
整理不易!点个赞呗!