11_组件Text

Text

文本
用于显示和处理多行文本

import tkinter as tk

window = tk.Tk()
window.title('hello thinter')
height = window.winfo_screenheight()
width = window.winfo_screenwidth()
window.geometry('400x300+%d+%d' % ((width - 400) / 2, (height - 300) / 2))
text = tk.Text(window, width=20, height=10)
# 在光标车插入数据
text.insert("insert", "你好啊")
# 在最后插入数据
text.insert("end", "你好啊")
text.pack()

def get_txt():
    param = text.get("1.0", "end")
    print("text内容：", param)

def del_txt():
    param = text.delete("1.0", "end")

tk.Button(window, text="获取文本", command=get_txt).pack()
tk.Button(window, text="删除内容", command=del_txt).pack()
window.mainloop()

选项	含义
autoseparators	设置实现“撤销”操作时，是否自动插入一个“分隔符”，默认True
maxundo	1,设置允许撤销操作的最大次数，默认值是0 2，设置为-1表示不限制
undo	设置是否开启“撤销功能”，默认False不开启
width	1，设置Text组件的宽度 2，单位是字符数，组件的实际宽度还取决于字体的大小
wrap	1，设置当一行文本的长度超过width选项设置的宽度时，是否自动换行 2，选项："none”(不自动换行)，"char(按字符换行)和"word”(按单词换行)
setgrid	设置一个布尔类型的值，确定是否启用网格控制，默认False
spacing1	设置Text组件的文本块中每一行与"上方"的空白间隔，默认值是0 自动换行不算
spacing2	设置Txt组件的文本块中自动换行的"各行间"的空白间隔，默认值是0
spacing3	设置Text组件的文本中每一行与"下方"的空白间隔，默认值是0
xscrollcommand，yscrollcommand	1，与组件scrollbar(滚动条)相关联（水平方向） 2，若输入内容超过该组件宽度，可以考虑设置
insertbackground	输入光标颜色，默认black
insertborderwidth	1，输入光标边框宽度 2，设置为非 0 值，光标样式会被设置为RAISED
tabs	1，定制Tag所描述的文本块中Tab按键的功能，默认为8个字符的宽度 2，可以定义多个制表位：tabs=('3c','5c','12c')表示前3个Tab宽度分别为3，5，12厘米，接着的Tab按照最后两个的差值计算，即：19，26，33厘米 3，'c'的含义是厘米"，其他单位：'i'(英寸)，'m'(毫米)和'p'(DPI，大约是"1i=72p) 4，如果是一个整型值，单位为像素
其他选项	参考Entry组件

1，delete()

delete(start, end=None)

删除给定范围的文本或嵌入对象
如果在给定范围内有任何 Marks 标记的位置，则将 Marks 移动到 start 参数开始的位置

2，get()

get(index1, index2=None)

返回 index1 到 index2（不包含）之间的文本
如果 index2 参数忽略，则返回一个字符
如果包含 image 和 window 的嵌入对象，均被忽略
如果包含有多行文本，那么自动插入换行符（'\n'）

3，insert()

insert(index, text, *tags)

在 index 参数指定的位置插入字符串
可选参数 tags 用于指定文本的样式
详见【Tags 用法】

4，index文本索引

index(index)

将 index 参数指定的位置以 "line.column" 的索引形式返回
index 参数支持任何格式的索引

INSERT	对应插入光标的位置
CURRENT	对应与鼠标坐标最接近的位置
END	对应 Text 控件的文本域中最后一个字符的下一个位置
"line.column"	表示某一行某一列的一个位置，比如 1.2 表示第一行第二列的一个位置
"line.end"	表示某一行到末尾的最后一个位置
SEL	一种针对于 Tag 的特殊索引用法，(SEL_FIRST,SEL_LAST) 表示当前被选中的范围

5，replace()

replace(index1, index2, chars, *args)

将 index1 到 index2 之间的内容替换为 chars 参数指定的字符串
如果需要为替换的内容添加 Tag，可以在 args 参数指定 Tag
详见【Tags 用法】

https://www.weixueyuan.net/a/630.html

http://c.biancheng.net/tkinter/text-widget.html

6，tags文本标签

tag_add(tagName, index1, index2=None)

为指定索引范围内的内容添加一个标签名字，如果 index2 不存在，则单独为 Index1 指定的内容添加 Tag

tag_names(index=None)

如果不带参数，表示返回 Text 组件中所有 Tags 的名字，若存在 index 参数则返回该位置上所有 Tags 的名字

tag_bind(tagName, sequence, func, add=None)

为 Tag 绑定事件，解除绑定使用 tag_unbind() 方法

tag_cget(tagName, option)

返回 tagName 指定的 option 选项的值

tag_config(tagName, cnf=None, **kw)

tag_configure()

设置 tagName 的选项
详见【Tags 用法】

tag_delete(*tagNames)

删除 tagNames 指定的 Tags

tag_lower(tagName, belowThis=None)

降低 Tag 的优先级
如果 belowThis 参数不为空，则表示 tagName 需要比 belowThis 指定的 Tag 优先级更低
详见上方【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 指定）

7，window

window_names()

返回 Text 组件中嵌入的所有 window 对象的名字

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_cget(index, option)

返回 index 参数指定的嵌入 window 对象的 option 选项的值
如果给定的位置没有嵌入 window 对象，则抛出 TclError 异常

window_config(index, cnf=None, **kw)

window_configure()

修改 index 参数指定的嵌入 window 对象的一个或多个 option 选项的值
如果给定的位置没有嵌入 window 对象，则抛出 TclError 异常

8，image

image_names()

返回 Text 组件中嵌入的所有 image 对象的名字

image_create(index, cnf={}, **kw)

在 index 参数指定的位置嵌入一个 image 对象
该 image 对象必须是 Tkinter 的 PhotoImage 或 BitmapImage 实例
可选选项 align：设定此图像的垂直对齐，可以是 "top"、"center"、"bottom" 或 "baseline"
可选选项 image：PhotoImage 或 BitmapImage 对象
可选选项 name：你可以为该图像实例命名，如果你忽略此选项，那么 Tkinter 会自动为其取一个独一无二的名字。
可选选项 padx：设置水平方向上的额外间距
可选选项 pady：设置垂直方向上的额外间距

image_cget(index, option)

返回 index 参数指定的嵌入 image 对象的 option 选项的值
如果给定的位置没有嵌入 image 对象，则抛出 TclError 异常

image_configure(index, **options)

修改 index 参数指定的嵌入 image 对象的一个或多个 option 选项的值
如果给定的位置没有嵌入 image 对象，则抛出 TclError 异常

9，edit

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，该方法无效

10，mark文本标记

mark_names()

返回 Text 组件中所有 Marks 的名字
包括两个特殊 Mark："insert" 和 "current"
注意："end" 是特殊的索引，不是 Mark

mark_set(markName, index)

移动 Mark 到 index 参数指定的位置
如果 markName 参数指定的 Mark 不存在，则创建一个新的 Mark

mark_unset(*markNames)

删除 markNames 指定的 Marks
不能删除预定义的 "insert" 和 "current"

mark_gravity(self, markName, direction=None)

设置 Mark 的方向，可以是 "left" 或 "right"（默认是 "right"，即如果在 Mark 处插入文本的话，Mark 将发生相应的移动以保持在插入文本的右侧）
如果设置为 "left"，那么在 Mark 处插入文本并不会移动 Mark（因为 Mark 在插入文本的左侧）
如果忽略 direction 参数，则返回指定 Mark 的方向
详见【Marks 用法】

mark_next(index)

返回在 index 指定的位置后边的一个 Mark 的名字
如果不存在则返回空字符串

mark_previous(index)

返回在 index 指定的位置前边的一个 Mark 的名字
如果不存在则返回空字符串

11，bbox()

bbox(index)

返回给定索引指定的字符的边界框
返回一个元组：(x, y, width, height)
如果该字符是不可见的，那么返回 None
注意：只有当 Text 组件被更新的时候该方法才有效，可以使用 update_idletasks() 方法先更新 Text 组件

12，compare()

compare(index1, op, index2)

返回对比 index1 和 index2 指定的两个字符的结果
op 是操作符：'<', '<=', '==', '>=', '>' 或 '!='（不支持 '<>' ）
返回布尔类型的值表示对比的结果

13，debug()

debug(boolean=None)

开启或关闭 Debug 状态

14，dlineinfo()

dlineinfo(index)

返回给定索引指定的字符所在行的边界框
返回一个元组：(x, y, width, height, offset)，offset 表示从该行的顶端到基线的偏移
如果该行不可见，则返回 None
注意：只有当 Text 组件被更新的时候该方法才有效，可以使用 update_idletasks() 方法先更新 Text 组件

15，dump()

dump(index1, index2=None, command=None, **kw)

返回 index1 和 index2 之间的内容
返回一个元组（关键词，值，索引），关键词参数的顺序为：all, image, mark, tag, text, window
默认关键词是 'all'，表示全部关键词均为选中状态
如果需要筛选个别关键词，可以用 dump(index1, index2, image=True, text=True) 这样的形式调用
如果指定了 command 函数，那么会为列表中的每一个三元组作为参数调用一次该函数（这种情况下，dump() 不返回值）

16，scan_mark()

scan_mark(x, y)

scan_dragto(x, y)

使用这种方式来实现 Text 组件内容的滚动
需要将鼠标按钮事件以及鼠标当前位置绑定到 scan_mark(x, y) 方法，然后将 <motion> 事件及当前鼠标位置绑定到 scan_dragto(x, y) 方法，就可以实现 Text 组件的内容在当前位置和 scan_mark(x, y) 指定的位置 (x, y) 之间滚动

17，search()

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 的字符个数）

18，see()

see(index)

滚动内容，确保 index 指定的位置可见

19，xview(*args)

xview_moveto(fraction)
xview_scroll(number, what)

该方法用于在水平方向上滚动 Text 组件的内容，一般通过绑定 Scollbar 组件的 command 选项来实现（具体操作参考：Scrollbar）
如果第一个参数是 "moveto"，则第二个参数表示滚动到指定的位置：0.0 表示最左端，1.0 表示最右端
如果第一个参数是 "scroll"，则第二个参数表示滚动的数量，第三个参数表示滚动的单位（可以是 "units" 或 "pages"），例如：xview("scroll", 3, "units") 表示向右滚动三行

20，yview(*args)

yview_moveto(fraction)
yview_scroll(number, what)

该方法用于在垂直方向上滚动 Text 组件的内容，一般通过绑定 Scollbar 组件的 command 选项来实现（具体操作参考：Scrollbar）

如果第一个参数是 “moveto”，则第二个参数表示滚动到指定的位置：0.0 表示最顶端，1.0 表示最底端
如果第一个参数是 “scroll”，则第二个参数表示滚动的数量，第三个参数表示滚动的单位（可以是 “units” 或 “pages”），例如：yview(“scroll”, 3, “pages”) 表示向下滚动三页