tkinter

窗口

1
2
3
4

import tkinter as tk    # 引入tkinter库，并取个别名（即外号)tk

root = tk.Tk()          # 创建窗口
root.mainloop()         # 窗口循环显示

属性设置

1
2
3
4
5
6
7
8

root['bg'] = 'red'      # 背景色，或root['background'] = 'red'

root['height'] = 700     # 窗口的高
root['width'] = 1000      # 窗口的宽

root['highlightthickness'] = 100    # 加亮区域的宽度
root['highlightcolor'] = 'yellow'   # 设置加亮区域在 有焦点 时的颜色
root['highlightbackground'] = 'black' # 设置加亮区域在 无焦点 时的颜色

常用方法

标题设置

1

root.title('你好')

移除窗口栏

1

root.overrideredirect(True)

窗口大小和位置

1
2

# 大小为1000x700，位置为距离屏幕，左右距即x轴100，上下距即y轴50
root.geometry('1000x700+100+50')

窗口刷新

1

root.update()

获取窗口位置

1
2
3
4

# 获取位置前必须刷新窗口
root.update()					
print( root.winfo_x() )
print( root.winfo_y() )

窗口最大最小尺寸

1
2
3

# 使窗口能拉取的大小在一个范围内
root.maxsize(200, 300)
root.minsize(20, 100)

窗口高宽是否可变

1
2

# True表示可以拉伸，False反之，该例子表示可拉伸宽度但固定了高度
root.resizable( width=True, height=False )

修改图标

1
2

# 参数是*.ico格式的图标路径
root.iconbitmap('path\python.ico')

事件绑定

格式

1

root.bind(event,handler)

• event：系统事件，比如按键的点击，鼠标的点击。其接受的参数是 python 指定的格式
• handler：事件发生后，要执行的方法的名称，执行的方法要有个固定的参数 event 方法格式为:

1
2

def handler_name(event):
    pass

下面例子，点击窗口会改变窗口颜色：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

import tkinter as tk

root = tk.Tk()

# 绑定的方法：点击窗口改变颜色
def callback(event):
    print('点击改变颜色')
    if root['bg'] == 'black':
        root['bg'] = 'white'
    else:
        root['bg'] = 'black'

# 窗口绑定
root.bind( '<Button-1>', callback )

root.mainloop()

事件

Tkinter 使用所谓的 事件队列 (event sequences) 暴露接口以绑定 handler 到相关事件. 事件以字符串的形式给出

1

<modifier-type-detail>

• 事件序列是包含在尖括号（<…>）中
• type 部分的内容是最重要的，它通常用于描述普通的事件类型，例如鼠标点击或键盘按键点击（详见下方）。
• modifier 部分的内容是可选的，它通常用于描述组合键，例如 Ctrl + c，Shift + 鼠标左键点击（详见下方）。
• detail 部分的内容是可选的，它通常用于描述具体的按键，例如 Button-1 表示鼠标左键。

例如

type

modifier

在事件序列中，modifier 部分的内容可以是以下这些：

Event 属性

当 Tkinter 去回调你定义的函数的时候，都会带着 Event 对象（作为参数）去调用，Event 对象以下这些属性你可以使用：

Key names

当事件为 <Key>，<KeyPress>，<KeyRelease> 的时候，detail 可以通过设定具体的按键名（keysym）来筛选。例如 表示按下键盘上的大写字母 H 时候触发事件，<Key-Tab> 表示按下键盘上的 Tab 按键的时候触发事件。

下表列举了键盘所有特殊按键的 keysym 和 keycode：

（下边按键码是对应美国标准 101 键盘的“Latin-1”字符集，键盘标准不同对应的按键码不同，但按键名是一样的）

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 捕获点击鼠标的位置
import tkinter as tk
 
root = tk.Tk()
 
def callback(event):
        print("点击位置：", event.x, event.y)
 
frame = tk.Frame(root, width = 200, height = 200)
frame.bind("<Button-1>", callback)
frame.pack()
 
root.mainloop()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 捕获键盘事件
import tkinter as tk
 
root = tk.Tk()
 
def callback(event):
        print("点击的键盘字符为：", event.char)
 
frame = tk.Frame(root, width = 200, height = 200)
frame.bind("<Key>", callback)
frame.focus_set()
frame.pack()
 
root.mainloop()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 捕获鼠标在组件上的运动轨迹
import tkinter as tk
 
root = tk.Tk()
 
def callback(event):
        print("当前位置为：", event.x, event.y)
 
frame = tk.Frame(root, width = 200, height = 200)
frame.bind("<Motion>", callback)
frame.pack()
 
root.mainloop()

控件

目前有 15 种 Tkinter 的控件。下表简单简单介绍各个控件：

标签 Label

Label（标签）组件用于在屏幕上显示文本或图像。Label 组件仅能显示单一字体的文本，但文本可以跨越多行。另外，还可以为其中的个别字符加上下划线（例如用于表示键盘快捷键）。

1
2
3
4
5
6
7
8

import tkinter as tk
 
master = tk.Tk()
 
w = tk.Label(master, text="Hello World!")
w.pack()
 
master.mainloop()

如果你没有指定 Label 的大小，那么 Label 的尺寸是正好可以容纳其内容而已

参数

Label(master=None, **options)

• master – 父组件

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

按钮 Button

Button（按钮）组件用于实现各种各样的按钮。Button 组件可以包含文本或图像，你可以将一个 Python 的函数或方法与之相关联，当按钮被按下时，对应的函数或方法将被自动执行

Button 组件仅能显示单一字体的文本，但文本可以跨越多行。另外，还可以为其中的个别字符加上下划线（例如用于表示键盘快捷键）。默认情况下，tab 按键被用于在按钮间切换

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

import tkinter as tk
 
master = tk.Tk()
 
def callback():
    print("我被调用了！")
 
b = tk.Button(master, text="执行", command=callback)
b.pack()
 
master.mainloop()

参数

Button(master=None, **options)

• master – 父组件

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

方法

flash()

– 刷新 Button 组件，该方法将重绘 Button 组件若干次（在 “active” 和 “normal” 状态间切换）。

invoke()

– 调用 Button 中 command 选项指定的函数或方法，并返回函数的返回值。 – 如果 Button 的 state (状态)是 “disabled”（不可用）或没有指定 command 选项，则该方法无效。

多选按钮 Checkbutton

Checkbutton（多选按钮）组件用于实现确定是否选择的按钮，当你希望表达“多选多”选项的时候，可以将一系列 Checkbutton 组合起来使用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

from tkinter import *
 
master = Tk()
 
var = IntVar()
 
c = Checkbutton(master, text="我是帅锅", variable=var)
c.pack()
 
mainloop()

默认情况下，variable 选项设置为 1 表示选中状态，反之设置为 0

如果你的 Tkinter 代码是放在类中的（在实际编程中你就应该这么干），那么将 variable 选项的值作为属性存储可能是更好的选择：

1
2
3
4
5
6
7

def __init__(self, master):
    self.var = tk.IntVar()
    c = tk.Checkbutton(master, text="DUANG~", variable=self.var, command=self.cb)
    c.pack()
 
def cb(self, event):
    print "variable is", self.var.get()

参数

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

• master – 父组件

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

方法

deselect()

– 取消 Checkbutton 组件的选中状态，也就是设置 variable 为 offvalue。

select()

– 将 Checkbutton 组件设置为选中状态，也就是设置 variable 为 onvalue。

toggle()

– 切换 Checkbutton 组件的状态（选中 -> 未选中 / 未选中 -> 选中）

flash()

– 刷新 Checkbutton 组件，该方法将重绘 Checkbutton 组件若干次（在"active” 和 “normal” 状态间切换）。

invoke()

– 调用 Checkbutton 中 command 选项指定的函数或方法，并返回函数的返回值。 – 如果 Checkbutton 的 state(状态)“disabled"是 （不可用）或没有指定 command 选项，则该方法无效。

单选按钮 Radiobutton

Radiobutton（单选按钮）组件用于实现多选一的问题，它几乎总是成组地被使用，其中所有成员共用相同的变量

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

import tkinter as tk
 
master = tk.Tk()
 
v = tk.IntVar()
v.set(2)
 
tk.Radiobutton(master, text="One", variable=v, value=1).pack(anchor="w")
tk.Radiobutton(master, text="Two", variable=v, value=2).pack(anchor="w")
tk.Radiobutton(master, text="Three", variable=v, value=3).pack(anchor="w")
 
master.mainloop()

如果按钮（选项）比较多，强烈建议您使用以下方式来初始化 Radiobutton 组件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

import tkinter as tk
 
master = tk.Tk()
 
GIRLS = [
    ("西施", 1),
    ("王昭君", 2),
    ("貂蝉", 3),
    ("杨玉环", 4)]
 
v = tk.IntVar()
 
for girl, num in GIRLS:
    b = tk.Radiobutton(master, text=girl, variable=v, value=num)
    b.pack(anchor="w")
 
master.mainloop()

参数

Radiobutton(master=None, **options)

• master – 父组件

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

方法

deselect() – 取消该按钮的选中状态。

select() – 将 Radiobutton 组件设置为选中状态。

flash() – 刷新 Radiobutton 组件，该方法将重绘 Radiobutton 组件若干次（在"active” 和 “normal” 状态间切换）。 – 该方法在调试的时候很有用，也可以使用此方法提醒用户激活了该按钮。

invoke() – 调用 Radiobutton 中 command 选项指定的函数或方法，并返回函数的返回值。 – 如果 Radiobutton 的 state(状态)“disabled"是 （不可用）或没有指定 command 选项，则该方法无效。

框架 Frame

Frame（框架）组件是在屏幕上的一个矩形区域。Frame 主要是作为其他组件的框架基础，或为其他组件提供间距填充

Frame 组件主要用于在复杂的布局中将其他组件分组，也用于填充间距和作为实现高级组件的基类

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

import tkinter as tk
 
master = tk.Tk()
 
tk.Label(text="天王盖地虎").pack()
 
separator = tk.Frame(height=2, bd=1, relief="sunken")
separator.pack(fill="x", padx=5, pady=5)
 
tk.Label(text="小鸡炖蘑菇").pack()
 
master.mainloop()

参数

Frame(master=None, **options)

• master – 父组件

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

标签框架 LabelFrame

LabelFrame 组件是 Frame 组件的变体。默认情况下，LabelFrame 会在其子组件的周围绘制一个边框以及一个标题

当你想要将一些相关的组件分为一组的时候，可以使用 LabelFrame 组件，比如一系列 Radiobutton（单选按钮）组件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

import tkinter as tk
 
master = tk.Tk()
 
group = tk.LabelFrame(master, text="你从哪里得知CSDN？", padx=5, pady=5)
group.pack(padx=10, pady=10)
 
v = tk.IntVar()
r1 = tk.Radiobutton(group, text="同学/同事介绍", variable=v, value=1).pack(anchor="w")
r2 = tk.Radiobutton(group, text="老婆大人介绍", variable=v, value=2).pack(anchor="w")
r3 = tk.Radiobutton(group, text="老师/学长介绍", variable=v, value=3).pack(anchor="w")
 
master.mainloop()

参数

LabelFrame(master=None, **options)

• master – 父组件

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

输入框 Entry

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

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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()

Entry 组件允许通过以下几种方式指定字符的位置

• 数字索引号：常规的 Python 索引号，从 0 开始
• “anchor”：对应第一个被选中的字符（如果有的话）
• “end”：对应已存在文本的后一个位置
• “insert”：对应插入光标的当前位置
• 使用鼠标坐标（"@x”）：x 是鼠标位置与 Entry 左侧边缘的水平距离，这样就可以通过鼠标相对地定位字符的位置

参数

*Entry(master=None, *options)

• master – 父组件

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

方法

delete(first, last=None)

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

get()

– 获得当前输入框的内容

index(index)

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

insert(index, text)

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

文本 Text

Text（文本）组件用于显示和处理多行文本。在 Tkinter 的所有组件中，Text 组件显得异常强大和灵活，适用于多种任务。虽然该组件的主要目的是显示多行文本，但它常常也被用于作为简单的文本编辑器和网页浏览器使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

import tkinter as tk
 
root = tk.Tk()
 
text = tk.Text(root)
text.pack()
 
# "insert" 索引表示插入光标当前的位置
text.insert("insert", "I love ")
text.insert("end", "Python.com!")
 
root.mainloop()

参数

*Text(master=None, *options)

• master – 父组件

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

方法

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) 一样

顶层窗口 Toplevel

Toplevel（顶级窗口）组件类似于 Frame 组件，但 Toplevel 组件是一个独立的顶级窗口，这种窗口通常拥有标题栏、边框等部件

Toplevel 组件通常用在显示额外的窗口、对话框和其他弹出窗口上

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

import tkinter as tk
 
root = tk.Tk()
 
def create():
    top = tk.Toplevel()
    top.title("Python")
 
    msg = tk.Message(top, text="I love Python!")
    msg.pack()
 
tk.Button(root, text="创建顶级窗口", command=create).pack()
 
root.mainloop()

参数

*Toplevel(master=None, *options)

• master – 父组件

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

菜单 Menu

Menu（菜单）组件用于实现顶级菜单、下拉菜单和弹出菜单

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

import tkinter as tk
 
root = tk.Tk()
 
def callback():
    print("~被调用了~")
 
# 创建一个顶级菜单
menubar = tk.Menu(root)
 
# 创建一个下拉菜单“文件”，然后将它添加到顶级菜单中
filemenu = tk.Menu(menubar, tearoff=False)
filemenu.add_command(label="打开", command=callback)
filemenu.add_command(label="保存", command=callback)
filemenu.add_separator()
filemenu.add_command(label="退出", command=root.quit)
menubar.add_cascade(label="文件", menu=filemenu)
 
# 创建另一个下拉菜单“编辑”，然后将它添加到顶级菜单中
editmenu = tk.Menu(menubar, tearoff=False)
editmenu.add_command(label="剪切", command=callback)
editmenu.add_command(label="拷贝", command=callback)
editmenu.add_command(label="粘贴", command=callback)
menubar.add_cascade(label="编辑", menu=editmenu)
 
# 显示菜单
root.config(menu=menubar)
 
root.mainloop()

参数

*Menu(master=None, *options)

• master – 父组件

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

方法

add(type, **options) – type 参数指定添加的菜单类型，可以是：“command”，“cascade”，“checkbutton”，“radiobutton” 或 “separator” – 还可以通过 options 选项设置菜单的属性，下表列举了 options 可以使用的选项和具体含义：

==add_cascade(**options)== – 添加一个父菜单 – 相当于 add(“cascade”, **options)

*add_checkbutton(*options) – 添加一个多选按钮的菜单项 – 相当于 add(“checkbutton”, **options)

==add_command(**options)== – 添加一个普通的命令菜单项 – 相当于 add(“command”, **options)

*add_radiobutton(*options) – 添加一个单选按钮的菜单项 – 相当于 add(“radiobutton”, **options)

*add_separator(*options) – 添加一条分割线 – 相当于 add(“separator”, **options)

delete(index1, index2=None) – 删除 index1 ~ index2（包含）的所有菜单项 – 如果忽略 index2 参数，则删除 index1 指向的菜单项 – 注意：对于一个被“撕下”的菜单，你无法使用该方法

entrycget(index, option) – 获得指定菜单项的某选项的值

*entryconfig(index, *options) – 设置指定菜单项的选项 – 选项的参数及具体含义请参考上方 add() 方法

*entryconfigure(index, *options) – 跟 entryconfig() 一样

index(index) – 返回与 index 参数相应的选项的序号（例如 e.index(“end”)）

*insert(index, itemType, *options) – 插入指定类型的菜单项到 index 参数指定的位置 – itemType 参数指定添加的菜单类型，可以是：“command”，“cascade”，“checkbutton”，“radiobutton” 或 “separator” – 选项的参数及具体含义请参考上方 add() 方法

*insert_cascade(index, *options) – 在 index 参数指定的位置添加一个父菜单 – 相当于 insert(“cascade”, **options)

*insert_checkbutton(index, *options) – 在 index 参数指定的位置添加一个多选按钮 – 相当于 insert(“checkbutton”, **options)

*insert_command(index, *options) – 在 index 参数指定的位置添加一个普通的命令菜单项 – 相当于 insert(“command”, **options)

*insert_radiobutton(index, *options) – 在 index 参数指定的位置添加一个单选按钮 – 相当于 insert(“radiobutton”, **options)

*insert_separator(index, *options) – 在 index 参数指定的位置添加一条分割线 – 相当于 insert(“separator”, **options)

invoke(index) – 调用 index 指定的菜单项相关联的方法 – 如果是单选按钮，设置该菜单项为选中状态 – 如果是多选按钮，切换该菜单项的选中状态

post(x, y) – 在指定的位置显示弹出菜单 – 参考上创建弹窗菜单的例子

type(index) – 获得 index 参数指定菜单项的类型 – 返回值可以是：“command”，“cascade”，“checkbutton”，“radiobutton” 或 “separator”

unpost() – 移除弹出菜单

yposition(index) – 返回 index 参数指定的菜单项的垂直偏移位置 – 该方法的目的是为了让你精确放置相对于当前鼠标的位置弹出菜单

布局管理器

pack、grid 和 place 均用于管理同在一个父组件下的所有组件的布局，其中：

• pack 是按添加顺序排列组件
• grid 是按行/列形式排列组件
• place 则允许程序员指定组件的大小和位置

我们常常会遇到的一个情况是将一个组件放到一个容器组件中，并填充整个父组件

pack

默认下，pack 是将添加的组件依次纵向排列

如果想要组件横向挨个儿排放，你可以使用 side 选项

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

import tkinter as tk
 
root = tk.Tk()
 
listbox = tk.Listbox(root)
listbox.pack(fill="both", expand=True)
 
for i in range(10):
        listbox.insert("end", str(i))
 
root.mainloop()

参数

*pack(*options)

– 下方表格详细列举了各个选项的具体含义和用法：

grid

使用 grid 排列组件，只需告诉它你想要将组件放置的位置（行/列，row 选项指定行，cloumn 选项指定列）。此外，你并不用提前指出网格（grid 分布给组件的位置称为网格）的尺寸，因为管理器会自动计算

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

import tkinter as tk
 
root = tk.Tk()
 
# column 默认值是 0
tk.Label(root, text="用户名").grid(row=0)
tk.Label(root, text="密码").grid(row=1)
 
tk.Entry(root).grid(row=0, column=1)
tk.Entry(root, show="*").grid(row=1, column=1)
 
root.mainloop()

默认情况下组件会居中显示在对应的网格里，你可以使用 sticky 选项来修改这一特性

有时候你可能需要用几个网格来放置一个组件，你只需要指定 rowspan 和 columnspan 就可以实现跨行和跨列的功能

参数

*grid(*options) – 下方表格详细列举了各个选项的具体含义和用法：

place

通常情况下不建议使用 place 布局管理器，因为对比起 pack 和 grid，place 要做更多的工作。不过纯在即合理，place 在一些特殊的情况下可以发挥妙用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

import tkinter as tk
 
root = tk.Tk()
 
def callback():
    print("正中靶心")
 
tk.Button(root, text="点我", command=callback).place(relx=0.5, rely=0.5, anchor="center")
 
root.mainloop()

relx 和 rely 选项指定的是相对于父组件的位置，范围是 00 ~ 1.0，因此 0.5 表示位于正中间。那么 relwidth 和 relheight 选项则是指定相对于父组件的尺寸

参数

*place(*options) – 下方表格详细列举了各个选项的具体含义和用法：

标准对话框

Tkinter 为了提供了三种标准对话框模块，它们分别是：

• messagebox
• filedialog
• colorchooser

messagebox（消息对话框）

1
2
3
4
5
6

import tkinter as tk
from tkinter import messagebox
 
messagebox.askokcancel("Python Demo", "发射核弹？")
 
tk.mainloop()

标准对话框样式

使用函数	对话框样式
askokcancel(title, message, options)
askquestion(title, message, options)
askretrycancel(title, message, options)
askyesno(title, message, options)
showerror(title, message, options)
showinfo(title, message, options)
showwarning(title, message, options)

参数

所有的这些函数都有相同的参数：

• title 参数毋庸置疑是设置标题栏的文本
• message 参数是设置对话框的主要文本内容，你可以用 ‘\n’ 来实现换行
• options 参数可以设置的选项和含义如下表所示

返回值

askokcancel()，askretrycancel() 和 askyesno() 返回布尔类型的值：

• 返回 True 表示用户点击了“确定”或“是”按钮
• 返回 False 表示用户点击了“取消”或“否”按钮

askquestion() 返回“yes”或“no”字符串表示用户点击了“是”或“否”按钮

showerror()，showinfo() 和 showwarning() 返回“ok”表示用户按下了“是”按钮

filedialog（文件对话框）

当你的应用程序需要使用打开文件或保存文件的功能时，文件对话框显得尤为重要

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

import tkinter as tk
from tkinter import filedialog
root = tk.Tk()
 
def callback():
    fileName = filedialog.askopenfilename()
    print(fileName)
 
tk.Button(root, text="打开文件", command=callback).pack()
 
root.mainloop()

filedialog 模块提供了两个函数：askopenfilename(**option) 和 asksaveasfilename(**option)，分别用于打开文件和保存文件

参数

两个函数可供设置的选项是一样的，下边列举了可用的选项及含义：

返回值

1. 如果用户选择了一个文件，那么返回值是该文件的完整路径

2. 如果用户点击了取消按钮，那么返回值是空字符串

colorchooser（颜色选择对话框）

颜色选择对话框提供一个友善的界面让用户选择需要的颜色

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

import tkinter as tk
from tkinter import colorchooser
 
root = tk.Tk()
 
def callback():
    fileName = colorchooser.askcolor()
    print(fileName)
 
tk.Button(root, text="选择颜色", command=callback).pack()
 
root.mainloop()

参数

askcolor(color, **option) 函数的 color 参数用于指定初始化的颜色，默认是浅灰色；

option 参数可以指定的选项及含义如下：

返回值

1. 如果用户选择一个颜色并按下“确定”按钮后，返回值是一个 2 元祖，第 1 个元素是选择的 RGB 颜色值，第 2 个元素是对应的 16 进制颜色值

2. 如果用户按下“取消”按钮，那么返回值是 (None, None)