tkinter.ttk --- Tk主题小部件¶
源代码: Lib/tkinter/ttk.py
tkinter.ttk 模块自 Tk 8.5 开始引入，可用于访问 Tk 风格的控件包。如果 Python 未基于 Tk 8.5 编译，只要安装了 Tile 仍可访问本模块。前一种采用 Tk 8.5 的方式带有更多好处，比如在 X11 系统下支持反锯齿字体渲染和透明窗口（需要 X11 中的窗口组管理器）。
tkinter.ttk 的基本设计思路，就是尽可能地把控件的行为代码与实现其外观的代码分离开来。
参见
- Tk 控件风格
一份文档介绍Tk支持的主题
使用 Ttk¶
开始使用 Ttk, 导入模块:
from tkinter import ttk
重写基础Tk部件,导入应跟随Tk导入:
from tkinter import *
from tkinter.ttk import *
这段代码会让以下几个 tkinter. ttk 控件（Button, Checkbutton, Entry, Frame, Label, LabelFrame, Menubutton, PanedWindow, Radiobutton, Scale 和 Scrollbar）自动替换掉 Tk 的对应控件。
使用新控件的直接好处，是拥有更好的跨平台的外观，但新旧控件并不完全兼容。主要区别在于，Ttk 组件不再包含“fg”、“bg”等与样式相关的参数 。而是用 ttk.Style 类来定义更美观的样式效果。
参见
- 将现有的应用程序转换为 Tile 控件，可参考 Converting existing applications to use Tile widgets 。
此文介绍使用新控件时的常见差别（使用 Tcl ）。
Ttk 部件¶
ttk 中有 18 种部件 ，其中十二种已存在于 tkinter 中: Button, Checkbutton, Entry, Frame, Label, LabelFrame, Menubutton, PanedWindow, Radiobutton, Scale, Scrollbar 以及 Spinbox。 另外六种是新增的: Combobox, Notebook, Progressbar, Separator, Sizegrip 以及 Treeview。 它们全都是 Widget 的子类。
ttk 控件可以改善应用程序的外观。如上所述，修改样式的代码与 tk 控件存在差异。
Tk 代码:
l1 = tkinter.Label(text="Test", fg="black", bg="white")
l2 = tkinter.Label(text="Test", fg="black", bg="white")
Ttk 代码:
style = ttk.Style()
style.configure("BW.TLabel", foreground="black", background="white")
l1 = ttk.Label(text="Test", style="BW.TLabel")
l2 = ttk.Label(text="Test", style="BW.TLabel")
有关 TtkStyling 的更多信息，请参阅 Style 类文档。
控件¶
ttk.Widget 定义了 Tk 主题小部件支持的标准选项和方法，不应该直接实例化。
标准选项¶
所有 ttk 小部件接受以下选项：
选项
描述
class -- 类
指定窗口类。在查询选项数据库中窗口的其他选项时，使用该类，确定窗口的默认绑定标签，以及选择窗口小部件的默认布局和样式。此选项仅为只读，并且只能在创建窗口时指定。
cursor
指定要用于窗口小部件的鼠标光标。如果设置为空字符串（默认值），则为父窗口小部件继承光标.
takefocus
确定窗口是否在键盘遍历期间接受焦点。返回0或1，返回空字符串。如果返回0，则表示在键盘遍历期间应该跳过该窗口。如果为1，则表示只要可以查看窗口就应该接收输入焦点。并且空字符串意味着遍历脚本决定是否关注窗口。
style
可用于指定自定义窗口小部件样式。
可滚动控件选项¶
控件支持以下选项使用滚动条控制.
选项
描述
xscroll命令
用于与垂直滚动条通讯.
当视图在部件窗口改变,部件将会基于scroll命令生成Tcl命令.
通常该参数由滚动条的
Scrollbar.set()方法组成。当窗口中的可见内容发生变化时，将会刷新滚动条的状态。yscroll命令
用于与垂直滚动条通讯.更多信息请参考上面的信息.
标签选项¶
以下选项支持标签,按钮已经其他类按钮的控件.
选项
描述
文本
指定显示在控件内的文本。
文本变量
指定一个变量名，其值将用于设置 text 参数。
下划线
设置文本字符串中带下划线字符的索引（基于0）。下划线字符用于激活快捷键。
图片
指定一个用于显示的图像。这是一个由1个或多个元素组成的列表。第一个元素是默认的图像名称。列表的其余部分是由
Style.map()定义的“状态/值对”的序列，指定控件在某状态或状态组合时要采用的图像。列表中的所有图像应具备相同的尺寸。compound
指定同时存在 text 和 image 参数时，应如何显示文本和对应的图片。合法的值包括：
text: 只显示文本
image: 只显示图片
top, bottom, left, right: 分别显示图片的上,下,左,右的文本.
none: 默认. 如果设置显示图片, 否则文本.
宽度
如果值大于零，指定文本标签留下多少空间，单位是字符数；如果值小于零，则指定最小宽度。如果等于零或未指定，则使用文本标签本身的宽度。
兼容性选项¶
选项
描述
状况
可以设为“normal”或“disabled”，以便控制“禁用”状态标志位。本参数只允许写入：用以改变控件的状态，但
Widget.state()方法不影响本参数。
控件状态¶
控件状态是无关状态标志的位图.
标志
描述
活动
鼠标光标经过控件并按下鼠标按钮，将引发动作。
禁用
在程序控制下控件是禁用的
焦点
控件有键盘焦点
按压
控件已被按下。
选择
勾选或单选框之类的控件，表示启用、选中状态。
背景
Windows 和 Mac 系统的窗口具有“激活”或后台的概念。后台窗口的控件会设置 foreground 参数，而前台窗口的控件则会清除此状态。
只读
控件不允许用户修改。
alternate
控件的备选显式格式。
无效的
控件的值是无效的
所谓的控件状态，就是一串状态名称的组合，可在某个名称前加上感叹号，表示该状态位是关闭的。
ttk.Widget¶
除了以下方法之外，ttk.Widget 还支持 tkinter.Widget.cget() 和 tkinter.Widget.configure() 方法。
-
class
tkinter.ttk.Widget¶ -
identify(x, y)¶ 返回位于 x y 的控件名称，如果该坐标点不属于任何控件，则返回空字符串。
x 和 y 是控件内的相对坐标，单位是像素。
-
instate(statespec, callback=None, *args, **kw)¶ 检测控件的状态。如果没有设置回调函数，那么当控件状态符合 statespec 时返回
True，否则返回False。如果指定了回调函数，那么当控件状态匹配 statespec 时将会调用回调函数，且带上参数 args。
-
state(statespec=None)¶ 修改或查询控件的状态。如果给出了 statespec，则会设置控件的状态，并返回一个新的*statespec*，表明哪些标志做过改动。如果未给出 statespec，则返回当前启用的状态标志。
statespec 通常是列表或元组类型。
-
组合框¶
ttk.Combobox 控件是文本框和下拉列表的组合体。该控件是 Entry 的子类。
除了从 Widget 继承的 Widget.cget() 、 Widget.configure() 、Widget.identify() 、Widget.instate() 和 Widget.state() 方法，以及从 Entry 继承的 Entry.bbox() 、 Entry.delete() 、 Entry.icursor() 、Entry.index() 、 Entry.insert() 、 Entry.selection() 、 Entry.xview() 方法，ttk.Combobox 还自带了其他几个方法。
选项¶
控件可设置以下参数：
选项
描述
exportselection
布尔值，如果设为 True，则控件的选中文字将关联为窗口管理器的选中文字（可由 Misc.selection_get 返回）。
justify
指定文本在控件中的对齐方式。可为 left、center、right 之一。
height
设置下拉列表框的高度。
postcommand
一条代码，（可用 Misc.register 进行注册），在显示之前将被调用。可用于选取要显示的值。
状况
normal 、readonly 或 disabled。在 readonly 状态下，数据不能直接编辑，用户只能从下拉列表中选取。在 normal 状态下，可直接编辑文本框。在 disabled 状态下，无法做任何交互。
文本变量
设置一个变量名，其值与控件的值关联。每当该变量对应的值发生变动时，控件值就会更新，反之亦然。参见
tkinter.StringVar。值
设置显示于下拉列表中的值。
宽度
设置为整数值，表示输入窗口的应有宽度，单位是字符单位（控件字体的平均字符宽度）。
虚拟事件¶
当用户从下拉列表中选择某个元素时，控件会生成一条 <<ComboboxSelected>> 虚拟事件。
Spinbox¶
ttk.Spinbox 控件是 ttk.Entry 的扩展，带有增减箭头。可用于数字或字符串列表。这是 Entry 的子类。
除了从 Widget 继承的 Widget.cget() 、 Widget.configure() 、Widget.identified() 、 Widget.instate() 和 Widget.state() 方法，以及从 Entry 继承的 Entry. bbox() 、 Entry.delete() 、 Entry.icursor() 、Entry.index() 、 Entry.insert() 、 Entry.xview() 方法，控件还自带了其他一些方法，在 ttk.Spinbox 中都有介绍。
选项¶
控件可设置以下参数：
选项 |
描述 |
|---|---|
从 |
浮点值。即递减按钮要递减的最小值。作为参数使用时必须写成 |
到 |
浮点值。即递增按钮能够到达的最大值。 |
增加 |
浮点值。指定递增/递减按钮每次的修改量。默认值为 1.0。 |
值 |
字符串或浮点值构成的序列。如若给出，则递增/递减会在此序列元素间循环，而不是增减数值。 |
wrap |
布尔值。若为 |
格式 |
字符串。指定递增/递减按钮的数字格式。必须以“%W.Pf”的格式给出，W 是填充的宽度，P 是小数精度，% 和 f 就是本身的含义。 |
命令 |
Python 回调函数。只要递增或递减按钮按下之后，就会进行不带参数的调用。 |
虚拟事件¶
用户若按下 <Up> ，则控件会生成 <<Increment>> 虚拟事件，若按下 <Down> 则会生成 <<Decrement>> 事件。
笔记本¶
Ttk Notebook 控件管理着多个窗口的集合，每次显示其中的一个。每个子窗口都与某个 tab 关联，可供用户选中以改变当前显示的窗口。
选项¶
控件可设置以下参数：
选项
描述
height
如若给出且大于 0，则指定子窗口面板的应有高度（不含内部缩进）。否则会采用所有子窗口面板的最大高度。
padding
指定在控件外部添加的留白。padding 是最多包含四个值的列表，指定左顶右底的空间。如果给出的元素少于四个，底部值默认为顶部值，右侧值默认为左侧值，顶部值默认为左侧值。
宽度
若给出且大于 0，则设置面板的应有宽度（不含内部 padding）。否则将采用所有子窗口面板的最大宽度。
Tab 选项¶
Tab 特有属性如下：
选项
描述
状况
可为 normal、disabled 或 disabled 之一。若为 disabled 则不能选中。若为 hidden 则不会显示。
sticky
指定子窗口在面板内的定位方式。应为包含零个或多个 n、s、e 、w 字符的字符串。每个字母表示子窗口应紧靠的方向（北、南、东或西），正如
grid()位置管理器所述。padding
指定控件和面板之间的留白空间。格式与本控件的 padding 属性相同。
文本
指定显示在 tab 上的文本。
图片
指定显示在 tab 上的图片。参见
Widget的 image 属性。compound
当文本和图片同时存在时，指定图片相对于文本的显示位置。合法的属性值参见 Label Options 。
下划线
指定下划线在文本字符串中的索引（基于0）。如果调用过了
Notebook.enable_traversal()，带下划线的字符将用于激活快捷键。
Tab 标识¶
The tab_id present in several methods of ttk.Notebook may take any
of the following forms:
位于 0 和 tab 总数之间的整数值。
子窗口的名称
以“@x,y”形式给出的位置，唯一标识了 tab 页。
字符串“current”，标识当前选中的 Tab。
字符串字面值 "end"，它返回标签页的数量 (仅适用于
Notebook.index())
虚拟事件¶
当选中一个新 tab 页之后，控件会生成一条 <<NotebookTabChanged>> 虚拟事件。
ttk.Notebook¶
-
class
tkinter.ttk.Notebook¶ -
add(child, **kw)¶ 添加一个新 tab 页。
如果窗口是由 Notebook 管理但处于隐藏状态，则会恢复到之前的位置。
可用属性请参见 Tab Options 。
-
forget(tab_id)¶ 删除 tab_id 指定的 tab 页，移除与其窗口的关联。
-
hide(tab_id)¶ 隐藏 tab_id 指定的 tab 页。
tab 页不会显示出来，但关联的窗口仍接受 Notebook 的管理，其配置属性会继续保留。隐藏的 tab 页可由
add()恢复。
-
identify(x, y)¶ 返回 tab 页内位置为 x、y 的控件名称，若不存在则返回空字符串。
-
index(tab_id)¶ 返回 tab_id 指定 tab 页的索引值，如果 tab_id 为 end 则返回 tab 页的总数。
-
insert(pos, child, **kw)¶ 在指定位置插入一个面板控件。
pos 可为字符串“end” 、整数索引值或子窗口名称。如果 child 已由 Notebook 管理，则移至指定位置。
可用属性请参见 Tab Options 。
-
select(tab_id=None)¶ 选中 tab_id 指定 tab。
显示关联的子窗口，之前选中的窗口将取消映射关系。如果省略 tab_id ，则返回当前选中面板的控件名称。
-
tab(tab_id, option=None, **kw)¶ 查询或修改 tab_id 指定 tab 的属性。
如果未给出 kw ，则返回由 tab 属性组成的字典。如果指定了 option，则返回其值。否则，设置属性值。
-
tabs()¶ 返回 Notebook 管理的窗口列表。
-
enable_traversal()¶ 为包含 Notebook 的顶层窗口启用键盘遍历。
这将为包含 Notebook 的顶层窗口增加如下键盘绑定关系：
Control-Tab ：将当前 tab 加入选中列表。
Shift-Control-Tab ：选中当前 tab 之前的页。
Alt-K ：这里 K 是任意 tab 页的快捷键（带下划线）字符，将会直接选中该 tab。
一个顶层窗口中可为多个 Notebook 启用键盘遍历，包括嵌套的 Notebook 。但仅当所有面板都将所在 Notebook 作为父控件时，键盘遍历才会生效。
-
Progressbar¶
ttk.Progressbar 控件可为长时间操作显示状态。可工作于两种模式：1）确定模式，显示相对完成进度；2）不确定模式，显示动画让用户知道工作正在进行中。
选项¶
控件可设置以下参数：
选项
描述
orient
horizontal 或 vertical。指定进度条的显示方向。
length
指定进度条长轴的长度（横向为宽度，纵向则为高度）。
模式
determinate 或 indeterminate。
maximum
设定最大值。默认为 100。
值
进度条的当前值。在 determinate 模式下代表已完成的工作量。在 indeterminate 模式下，解释为 maximum 的模；也就是说，当本值增至 maximum 时，进度条完成了一个“周期”。
variable
与属性值关联的变量名。若给出，则当变量值变化时会自动设为进度条的值。
phase
只读属性。只要值大于 0 且在 determinate 模式下小于最大值，控件就会定期增大该属性值。当前主题可利用本属性提供额外的动画效果。
ttk.Progressbar¶
-
class
tkinter.ttk.Progressbar¶ -
start(interval=None)¶ 启动自动递增模式：安排一个循环的定时器事件，每隔 interval 毫秒调用一次
Progressbar.step()。interval 可省略，默认为 50毫秒。
-
step(amount=None)¶ 将进度条的值增加 amount。
amount 可省略，默认为 1.0。
-
stop()¶ 停止自增模式：取消所有由
Progressbar.start()启动的循环定时器事件。
-
Separator¶
The ttk.Separator widget displays a horizontal or vertical separator
bar.
除由 ttk.Widget 继承而来的方法外，没有定义其他方法。
Sizegrip¶
ttk.Sizegrip 控件允许用户通过按下并拖动控制柄来调整内部顶层窗口的大小。
除由 ttk.Widget 继承的之外，没有其他属性和方法。
与平台相关的注意事项¶
在 MacOS X 中，顶层窗口自动内置了大小控制柄。再加一个
Sizegrip也没什么坏处，因为内置的控制柄会盖住 Sizegrip 控件。
Bug¶
假如内部的顶层窗口位置是相对于屏幕的右侧或底部进行设置的，那么
Sizegrip控件将不会改变窗口的大小。仅支持东南方向的缩放。
Treeview¶
ttk.Treeview 控件可将多项内容分层级显示。每个数据项抖带有一个文本标签、一张图片（可选）和一个数据列表（可选）。这些数据值将在树标签后面分列显示。
数据值的显示顺序可用属性 displaycolumns 进行控制。树控件还可以显示列标题。数据列可通过数字或名称进行访问，各列的名称在属性 columns 中列出。参阅 Column Identifiers。
每个数据项都由唯一名称进行标识。如果调用者未提供数据项的 ID，树控件会自动生成。根有且只有一个，名为 {}。根本身不会显示出来；其子项将显示在顶层。
每个数据项均带有 tag 列表，可用于绑定事件及控制外观。
Treeview 组件支持水平和垂直滚动，滚动时会依据 Scrollable Widget Options 描述的属性和 Treeview.xview() 和 Treeview.yview() 方法。
选项¶
控件可设置以下参数：
选项
描述
columns
列标识的列表，指定列的数量和名称。
displaycolumns
列标识的列表（索引可为符号或整数），指定要显示的数据列及显示顺序，或者字符串 “#all”。
height
指定可见的行数。注意：所需宽度由各列宽度之和决定。
padding
指定控件内部的留白。为不超过四个元素的长度列表。
selectmode
控制内部类如何进行选中项的管理。可为 extended、browse 或 none。若设为 extended（默认），则可选中多个项。若为 browse ，则每次只能选中一项。若为 none，则无法修改选中项。
请注意，代码和 tag 绑定可自由进行选中操作，不受本属性的限制。
show
由0个或下列值组成的列表，指定要显示树的哪些元素。
tree ：在 #0 列显示树的文本标签。
headings ：显示标题行。
默认为“tree headings”，显示所有元素。
** 注意** ：第 #0 列一定是指 tree 列，即便未设置 show="tree" 也一样。
数据项的属性¶
可在插入和数据项操作时设置以下属性。
选项
描述
文本
用于显示的文本标签。
图片
Tk 图片对象，显示在文本标签左侧。
值
关联的数据值列表。
每个数据项关联的数据数量应与 columns 属性相同。如果比 columns 属性的少，剩下的值将视为空。如果多于 columns 属性的，多余数据将被忽略。
open
True或False，表明是否显示数据项的子树。tags
与该数据项关联的 tag 列表。
tag 属性¶
tag 可定义以下属性：
选项
描述
foreground
定义文本前景色。
背景
定义单元格或数据项的背景色。
font
定义文本的字体。
图片
定义数据项的图片，当 image 属性为空时使用。
列标识¶
列标识可用以下格式给出：
由 columns 属性给出的符号名。
整数值 n，指定第 n 列。
#n 的字符串格式，n 是整数，指定第 n 个显示列。
注释:
数据项属性的显示顺序可能与存储顺序不一样。
#0 列一定是指 tree 列，即便未指定 show="tree" 也是一样。
数据列号是指属性值列表中的索引值，显示列号是指显示在树控件中的列号。树的文本标签将显示在 #0 列。如果未设置 displaycolumns 属性，则数据列 n 将显示在第 #n+1 列。再次强调一下，#0 列一定是指 tree 列 。
虚拟事件¶
Treeview 控件会生成以下虚拟事件。
Event
描述
<<TreeviewSelect>>
当选中项发生变化时生成。
<<TreeviewOpen>>
当焦点所在项的 open= True 时立即生成。
<<TreeviewClose>>
当焦点所在项的 open= True 之后立即生成。
Treeview.focus() 和 Treeview.selection() 方法可用于确认涉及的数据项。
ttk.Treeview¶
-
class
tkinter.ttk.Treeview¶ -
bbox(item, column=None)¶ 返回某 数据项 的边界（相对于控件窗口的坐标），形式为 (x, y, width, height) 。
若给出了 column，则返回该单元格的边界。若该 数据项 不可见（即从属于已关闭项或滚动至屏幕外），则返回空字符串。
-
get_children(item=None)¶ 返回从属于 item 的下级数据项列表。
若未给出 item ，则返回根的下级。
-
set_children(item, *newchildren)¶ 用 newchildren 替换 item 的下级数据。
对于 item 中存在而 newchildren 中不存在的数据项，会从树中移除。newchildren 中的数据不能是 item 的上级。注意，未给出 newchildren 会导致 item 的子项被移除。
-
column(column, option=None, **kw)¶ 查询或修改 column 的属性。
如果未给出 kw，则返回属性值的字典。若指定了 option，则会返回该属性值。否则将设置属性值。
合法的 属性/值 可为：
- id
返回列名。这是只读属性。
- anchor：标准的 Tk 锚点值。
指定该列的文本在单元格内的对齐方式。
- minwidth：宽度。
列的最小宽度，单位是像素。在缩放控件或用户拖动某一列时，Treeview 会保证列宽不小于此值。
- stretch:
True/False 指明列宽度是否应该在部件大小被改变时进行相应的调整。
- stretch:
- width: width
以像素表示的列宽度。
要配置树的列，则调用此方法并附带参数 column = "#0"
-
delete(*items)¶ 删除所有 items 及其下属。
根不能删除。
-
detach(*items)¶ 将所有 items 与树解除关联。
数据项及其下属依然存在，后续可以重新插入，目前只是不显示出来。
根不能解除关联。
-
exists(item)¶ 如果给出的 item 位于树中，则返回
True。
-
focus(item=None)¶ 如果给出 item 则设为当前焦点。否则返回当前焦点所在数据项，若无则返回 ''。
-
heading(column, option=None, **kw)¶ 查询或修改某 column 的标题。
若未给出 kw，则返回列标题组成的列表。若给出了 option 则返回对应属性值。否则，设置属性值。
合法的 属性/值 可为：
- text：文本。
显示为列标题的文本。
- image：图片名称
指定显示在列标题右侧的图片。
- anchor：锚点
指定列标题文本的对齐方式。应为标准的 Tk 锚点值。
- command：回调函数
点击列标题时执行的回调函数。
若要对 tree 列进行设置，请带上 column = "#0" 进行调用。
-
identify(component, x, y)¶ 返回 x、y 位置上 component 控件的描述信息，如果此处没有这种控件，则返回空字符串。
-
identify_row(y)¶ 返回 y 位置上的数据项 ID。
-
identify_column(x)¶ 返回 x 位置上的单元格所在的数据列 ID。
tree 列的 ID 为 #0 。
-
identify_region(x, y)¶ 返回以下值之一：
region
区域
标题栏
树的标题栏区域。
heading
两个列标题之间的间隔区域。
tree
树区域。
cell
数据单元格。
可用性：Tk 8.6。
-
identify_element(x, y)¶ 返回位于 x 、y 的数据项。
可用性：Tk 8.6。
-
index(item)¶ 返回 item 在其数据项列表中的整数索引。
-
insert(parent, index, iid=None, **kw)¶ 新建一个数据项并返回其 ID。
parent 是父项的 ID，若要新建顶级项则为空字符串。 index 是整数或“end”，指明在父项的子项列表中的插入位置。如果 index 小于等于0，则在开头插入新节点；如果 index 大于或等于当前子节点数，则将其插入末尾。如果给出了 iid，则将其用作数据项 ID； iid 不得存在于树中。否则会新生成一个唯一 ID。
此处可设置的属性请参阅 Item Options 。
-
item(item, option=None, **kw)¶ 查询或修改某 item 的属性。
如果未给出 option，则返回属性/值构成的字典。如果给出了 option，则返回该属性的值。否则，将属性设为 kw 给出的值。
-
move(item, parent, index)¶ 将 item 移至指定位置，父项为 parent ，子项列表索引为 index 。
将数据项移入其子项之下是非法的。如果 index 小于等于0，item 将被移到开头；如果大于等于子项的总数，则被移至最后。如果 item 已解除关联，则会被重新连接。
-
next(item)¶ 返回 item 的下一个相邻项，如果 item 是父项的最后一个子项，则返回 ''。
-
parent(item)¶ 返回 item 的父项 ID，如果 item 为顶级节点，则返回 ''。
-
prev(item)¶ 返回 item 的前一个相邻项，若 item 为父项的第一个子项，则返回 ''。
-
reattach(item, parent, index)¶ Treeview.move()的别名。
-
see(item)¶ 确保 item 可见。
将 item 所有上级的 open 属性设为
True，必要时会滚动控件，让 item 处于树的可见部分。
-
selection(selop=None, items=None)¶ If selop is not specified, returns selected items. Otherwise, it will act according to the following selection methods.
Deprecated since version 3.6, will be removed in version 3.8: Using
selection()for changing the selection state is deprecated. Use the following selection methods instead.
-
selection_set(*items)¶ 让 items 成为新的选中项。
在 3.6 版更改: items 可作为多个单独的参数传递，而不是作为一个元组。
-
selection_add(*items)¶ 将 items 加入选中项。
在 3.6 版更改: items 可作为多个单独的参数传递，而不是作为一个元组。
-
selection_remove(*items)¶ 从选中项中移除 items 。
在 3.6 版更改: items 可作为多个单独的参数传递，而不是作为一个元组。
-
selection_toggle(*items)¶ 切换 items 中各项的选中状态。
在 3.6 版更改: items 可作为多个单独的参数传递，而不是作为一个元组。
-
set(item, column=None, value=None)¶ 若带一个参数，则返回指定 item 的列/值字典。若带两个参数，则返回 column 的当前值。若带三个参数，则将 item 的 column 设为 value。
-
tag_bind(tagname, sequence=None, callback=None)¶ 为 tag 为 tagname 的数据项绑定事件 sequence 的回调函数。当事件分发给该数据项时，tag 参数为 tagname 的全部数据项的回调都会被调用到。
-
tag_configure(tagname, option=None, **kw)¶ 查询或修改 tagname 指定项的参数。
如果给出了 kw，则返回 tagname 项的属性字典。如果给出了 option，则返回 tagname 项的 option 属性值。否则，设置 tagname 项的属性值。
-
tag_has(tagname, item=None)¶ 如果给出了 item ，则依据 item 是否具备 tagname 而返回 1 或 0。否则，返回 tag 为 tagname 的所有数据项构成的列表。
可用性：Tk 8.6。
-
xview(*args)¶ 查询或修改 Treeview 的横向位置。
-
yview(*args)¶ 查询或修改 Treeview 的纵向位置。
-
Ttk 风格¶
ttk 的每种控件都赋有一个样式，指定了控件内的元素及其排列方式，以及元素属性的动态和默认设置。默认情况下，样式名与控件的类名相同，但可能会被控件的 style 属性覆盖。如果不知道控件的类名，可用 Misc.winfo_class() 方法获取（somewidget.winfo_class()）。
参见
- Tcl'2004 会议报告
文章解释了主题引擎的工作原理。
-
class
tkinter.ttk.Style¶ 用于操控风格数据库的类。
-
configure(style, query_opt=None, **kw)¶ 查询或设置 style 的默认参数。
Each key in kw is an option and each value is a string identifying the value for that option.
例如，要将默认按钮改为扁平样式，并带有留白和各种背景色：
from tkinter import ttk import tkinter root = tkinter.Tk() ttk.Style().configure("TButton", padding=6, relief="flat", background="#ccc") btn = ttk.Button(text="Sample") btn.pack() root.mainloop()
-
map(style, query_opt=None, **kw)¶ 查询或设置 style 的指定属性的动态值。
kw 的每个键都是一个属性，每个值通常应为列表或元组，其中包含以元组、列表或其他形式组合而成的状态标识（statespec）。状态标识是由一个或多个状态组合，加上一个值组成。
举个例子能更清晰些：
import tkinter from tkinter import ttk root = tkinter.Tk() style = ttk.Style() style.map("C.TButton", foreground=[('pressed', 'red'), ('active', 'blue')], background=[('pressed', '!disabled', 'black'), ('active', 'white')] ) colored_btn = ttk.Button(text="Test", style="C.TButton").pack() root.mainloop()
请注意，要点是属性的（状态，值）序列的顺序，如果前景色属性的顺序改为
[('active', 'blue'), ('pressed', 'red')]，则控件处于激活或按下状态时的前景色将为蓝色。
-
lookup(style, option, state=None, default=None)¶ 返回 style 中的 option 属性值。
如果给出了 state ，则应是一个或多个状态组成的序列。如果设置了 default 参数，则在属性值缺失时会用作后备值。
若要检测按钮的默认字体，可以：
from tkinter import ttk print(ttk.Style().lookup("TButton", "font"))
-
layout(style, layoutspec=None)¶ 按照 style 定义控件布局。如果省略了 layoutspec，则返回该样式的布局属性。
若给出了 layoutspec，则应为一个列表或其他的序列类型（不包括字符串），其中的数据项应为元组类型，第一项是布局名称，第二项的格式应符合 Layouts 的描述。
以下示例有助于理解这种格式（这里并没有实际意义）：
from tkinter import ttk import tkinter root = tkinter.Tk() style = ttk.Style() style.layout("TMenubutton", [ ("Menubutton.background", None), ("Menubutton.button", {"children": [("Menubutton.focus", {"children": [("Menubutton.padding", {"children": [("Menubutton.label", {"side": "left", "expand": 1})] })] })] }), ]) mbtn = ttk.Menubutton(text='Text') mbtn.pack() root.mainloop()
-
element_create(elementname, etype, *args, **kw)¶ 在当前主题中创建一个新元素 etype ，应为 image、from 或 vsapi。后者仅在 Windows XP 和 Vista 版的 Tk 8.6a 中可用，此处不再赘述。
如果用了 image，则 args 应包含默认的图片名，后面跟着 状态标识/值（这里是 imagespec），kw 可带有以下属性：
- border=padding
padding 是由不超过四个整数构成的列表，分别定义了左、顶、右、底的边界。
- height=height
定义了元素的最小高度。如果小于零，则默认采用图片本身的高度。
- padding=padding
定义了元素的内部留白。若未指定则默认采用 border 值。
- sticky=spec
定义了图片的对齐方式。spec 包含零个或多个 n、s、w、e 字符。
- width=width
定义了元素的最小宽度。如果小于零，则默认采用图片本身的宽度。
如果 etype 的值用了 from，则
element_create()将复制一个现有的元素。 args 应包含主题名和可选的要复制的元素。若未给出要克隆的元素，则采用空元素。 kw 参数将被丢弃。
-
element_names()¶ 返回当前主题已定义的元素列表 。
-
element_options(elementname)¶ 返回 elementname 的属性列表。
-
theme_create(themename, parent=None, settings=None)¶ 新建一个主题。
如果 themename 已经存在，则会报错。如果给出了 parent，则新主题将从父主题继承样式、元素和布局。若给出了 settings ，则语法应与
theme_settings()的相同。
-
theme_settings(themename, settings)¶ 将当前主题临时设为 themename，并应用 settings，然后恢复之前的主题。
settings 中的每个键都是一种样式而每个值可能包含 'configure', 'map', 'layout' 和 'element create' 等键并且它们被预期具有与分别由
Style.configure(),Style.map(),Style.layout()和Style.element_create()方法所指定的相符的格式。以下例子会对 Combobox 的默认主题稍作修改：
from tkinter import ttk import tkinter root = tkinter.Tk() style = ttk.Style() style.theme_settings("default", { "TCombobox": { "configure": {"padding": 5}, "map": { "background": [("active", "green2"), ("!disabled", "green4")], "fieldbackground": [("!disabled", "green3")], "foreground": [("focus", "OliveDrab1"), ("!disabled", "OliveDrab2")] } } }) combo = ttk.Combobox().pack() root.mainloop()
-
theme_names()¶ 返回所有已知主题的列表。
-
theme_use(themename=None)¶ 若未给出 themename，则返回正在使用的主题。否则，将当前主题设为 themename，刷新所有控件并引发 <<ThemeChanged>> 事件。
-
布局¶
布局在没有属性时可以为 None ，或是定义了元素排列方式的属性字典。布局机制采用了位置管理器的简化版本：给定一个初始容器（cavity），为每个元素都分配一个包装（parcel）。合法的选项/值包括：
- side: whichside
指定元素置于容器的哪一侧； 顶、右、底或左。如果省略，则该元素将占据整个容器。
- sticky: nswe
指定元素在已分配包装盒内的放置位置。
- unit: 0 或 1
如果设为 1，则将元素及其所有后代均视作单个元素以供
Widget.identify()等使用。 它被用于滚动条之类带有控制柄的东西。
- children: [sublayout... ]
指定要放置于元素内的元素列表。每个元素都是一个元组（或其他序列类型），其中第一项是布局名称，另一项是个 Layout 。