标准选项

所有ttk小部件接受以下选项：

选项	描述
class	指定窗口类。在查询选项数据库中窗口的其他选项时，使用该类，确定窗口的默认绑定标签，以及选择窗口小部件的默认布局和样式。此选项仅为只读，并且只能在创建窗口时指定.
cursor	指定要用于窗口小部件的鼠标光标。如果设置为空字符串（默认值），则为父窗口小部件继承光标.
takefocus	确定窗口是否在键盘遍历期间接受焦点。返回0或1，返回空字符串。如果返回0，则表示在键盘遍历期间应该跳过该窗口。如果为1，则表示只要可以查看窗口就应该接收输入焦点。并且空字符串意味着遍历脚本决定是否关注窗口.
style	可用于指定自定义窗口小部件样式.

可滚动窗口小部件选项

由ascrollbar控制的窗口小部件支持以下选项.

Option	Description
xscrollcommand	用于与水平滚动条进行通信. 当小部件窗口中的视图发生变化时，小部件将根据scrollcommand生成一个Tcl命令. 通常这个选项包含方法Scrollbar.set()一些滚动条。只要窗口中的视图发生变化，这将导致滚动条更新.
yscrollcommand	用于与垂直滚动条进行通信。有关更多信息，请参阅上文.

标签选项

标签，按钮和其他类似按钮的小部件支持以下选项.

选项	说明
文本	指定要在窗口小部件内显示的文本字符串.
textvariable	指定其值的名称将用于代替text选项资源.
underline	如果设置，则指定文本字符串中字符tounderline的索引（从0开始）。下划线字符用于助记激活.
image	指定要显示的图像。这是一个或多个元素的列表。第一个元素是默认图像名称。如果状态规范/值对的序列由Style.map()定义，则指定不同的映像，当窗口小部件处于特定状态或状态组合时，使用该列表。列表中的所有图像应该具有相同的大小.
化合物	指定如何在文本和图像选项都存在的情况下显示相对于文本的图像。有效值为： 文字：仅显示文字 图片：仅显示图片 顶部，底部，左侧，右侧：分别显示文字上方，下方，左侧或右侧的图像. none：默认值。如果存在则显示图像，否则显示文件.
width	如果大于零，则指定为文本标签分配多少空间（内容宽度），如果小于零，则指定最小宽度。如果为零或未指定，则使用文本标签的自然宽度.

兼容性选项

选项	说明
状态	可以设置为“正常”或“禁用”以控制“禁用”状态位。这是一个只写选项：设置它会改变窗口状态，但Widget.state()方法不会影响这个选项.

小部件状态

小部件状态是独立状态标志的位图.

Flag	描述
active	鼠标光标位于窗口小部件上，按下鼠标按钮将导致一些操作
禁用	在程序控制下窗口小部件被禁用
焦点	窗口小部件有键盘焦点
按	小工具被按下
选中	“开”，“真”或“当前”，用于检查按钮和半按钮
background	Windows和Mac有一个“活动”或前景窗口的概念。background状态是为abackground窗口中的小部件设置的，并且为前景窗口中的//清除
只读	小部件不应该允许用户修改
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)

测试小部件的状态。如果未指定回调，则返回True如果窗口小部件状态匹配statespec和False否则。如果指定了callbackis，那么如果widget状态匹配statespec.

state（statespec=None）

修改或查询widget状态，则使用args调用它。如果指定了statespec，则根据它设置thewidget状态并返回一个新的statespec表示更改了哪些标志。如果没有指定statespec，则返回当前启用的状态标志.

statespec通常是一个列表或元组.

中描述选项

这个小部件接受以下特定选项：

选项	说明
exportselection	布尔值。如果设置，则窗口小部件选择链接到窗口管理器选择（例如，可以通过调用Misc.selection_get来返回）.
justify	指定文本在窗口小部件中的对齐方式。of“left”，“center”或“right”.
height	指定弹出列表框的高度，以行为单位.
postcommand	在显示值之前立即调用的脚本（可能是使用Misc.register注册的）。它可以指定显示哪些值.
state	“正常”，“只读”或“禁用”之一。在“只读”状态下，可能无法直接编辑该值，并且用户只能从下拉列表中选择值。在“正常”状态下，文本字段可以直接编辑。在“禁用”状态下，不可能进行交互.
textvariable	指定其值链接到窗口小部件值的名称。每当与该名称关联的值更改时，窗口小部件值都会更新，反之亦然。请参阅tkinter.StringVar.
values	指定要在下拉列表框中显示的值列表.
width	指定一个整数值，表示输入窗口的所需宽度，以小工具的字体的平均大小字符为单位。

虚拟事件

组合框小部件生成＆lt;＆lt;＆lt;＆lt;＆lt;＆lt;＆ComboboxSelected＆gt;＆gt; 虚拟事件当用户从值列表中选择一个元素时

tttt.Combobox

class tkinter.ttk.Combobox

current(newindex=None）

如果指定newindex，则将组合框值设置为元素位置newindex。否则，返回当前值的索引或-1，如果当前值不在值列表中.

get ()

返回组合框的当前值.

set (value)

将组合框的值设为value.

中描述选项

这个小部件接受以下特定选项：

虚拟事件

旋转框小部件生成＆lt;＆lt; Increment＆gt;＆gt; 用户按下＆lt; Up＆gt;时的虚拟事件，以及＆lt;＆lt;＆lt; \u0026cre;＆gt;＆gt; 虚拟事件时userpresses＆lt; Down＆gt; .

ttk.Spinbox

class tkinter.ttk.Spinbox

get（）

返回spinbox的当前值.

set(value)

将spinbox的值设为value.

选项

这个小部件接受以下特定选项：

选项	描述
高度	如果存在且大于零，则指定窗格区域的所需高度（不包括内部填充或制表符）。否则，使用所有窗格的最大高度.
padding	指定要在笔记本外部添加的额外空间量。填充是一个列表，最多四个长度规格左上角。如果指定少于四个元素，则底部默认为top，right defaultsto left，top默认为left.
width	如果存在且大于零，则指定窗格区域的所需宽度（不包括内部填充）。否则，使用所有窗格的最大宽度.

选项

标签还有特定选项：

选项	说明
状态	“正常”，“禁用”或“隐藏”。如果“禁用”，则选项卡不可选。如果“隐藏”，则不显示标签.
sticky	指定子窗口在窗格区域中的定位方式。Value是包含零个或多个字符“n”，“s”，“e”或“w”的字符串。每个字母指的是儿童窗口所要求的旁边（北，南，东或西），按照grid()geometry manager.
padding	指定在thenotebook和此窗格之间添加的额外空间量。语法与此小部件使用的选项键相同.
text	指定要在选项卡中显示的文本.
image	指定要在选项卡中显示的图像。请参阅Widget.
复合	指定如何显示相对于文本的图像，如果存在选项文本和图像。SeeLabel选择法律价值.
underline	指定要在文本字符串中加下划线的字符的索引（从0开始）。带下划线的字符用于形式激活，如果Notebook.enable_traversal()被称为

标签

tab_id出现在ttk.Notebook可以采取以下任何一种形式：

• 零和标签数量之间的整数
• 儿童窗口的名称
• 形式为“@ x，y”的位置规范，用于标识选项卡
• 文字字符串“current”，用于标识当前选定的选项卡
• 文字字符串“end”，返回标签数量（仅对Notebook.index()有效）

虚拟事件

这个小部件生成一个＆lt;＆LT; NotebookTabChanged＆GT;＆GT; 选择新标签后的虚拟事件.

ttk.Notebook

class tkinter.ttk.Notebook

add(child, **kw)

在笔记本上添加新标签.

如果窗口当前由笔记本管理但是隐藏了，则它将恢复到之前的位置.

查看选项卡可用选项列表的选项.

forget(tab_id)

删除tab_id指定的标签，映射并取消管理相关窗口.

hide (tab_id)

隐藏tab_id.

该选项卡不会显示，但关联的窗口仍由笔记本管理，并记住其配置。隐藏的标签可以用add()命令恢复

identify// (x, y）

返回位置x, y的tab元素的名称，如果没有则返回空字符串

index// (tab_id)

返回选项卡的数字索引由tab_id指定，或者tab_id是字符串“end”.

insert (pos, child, **kw)

在指定位置插入窗格.

pos是字符串“end”，整数索引，或者是受管子级的名称。如果child已经由笔记本管理，移动到指定的位置.

有关可用选项列表，请参阅选项卡选项.

select（tab_id=None）

选择指定的tab_id.

将显示关联的子窗口，并且未映射先前选择的窗口（如果不同）。如果tab_idisomitted，返回当前所选窗格的窗口小部件名称.

tab(tab_id, option=None, **kw)

查询或修改特定的选项tab_id.

如果kw未给出，返回选项卡选项值的字典。如果指定了option，则返回该option的值。否则，将选项设置为相应的值.

tabs()

返回由笔记本管理的窗口列表.

enable_traversal（）

为包含此笔记本的顶层窗口启用键盘遍历.

这将扩展包含thenotebook的顶层窗口的绑定，如下所示：

• Control-Tab：选择当前所选标签后的标签.
• Shift-Control-Tab：选择当前所选标签之前的标签.
• Alt-K ：其中K是任何标签的助记符（下划线）字符，将选择该标签.

可以为单个顶层中的多个笔记本启用遍历，包括嵌套笔记本。但是，如果所有窗格都有作为母版的笔记本，笔记本遍历才能正常工作.

选项

这个小部件接受以下特定选项：

选项	描述
东方	其中一个“水平”或“垂直”。指定进度条的方向.
length	指定进度条长轴的长度（水平宽度，垂直高度）.
模式	“确定”或“不确定”之一.
最大值	指定最大值的数字。默认为100.
value	进度条的当前值。在“确定”模式中，这表示已完成的工作量。在“不确定”模式下，它被解释为modulo maximum;也就是说，进度条在其值增加maximum.
变量	与选项值链接的名称。如果指定，进度条的值将自动设置为该名称的值，只要后者被修改.
phase	只读选项。只要窗口小部件的值大于0，并且不确定模式小于最大值，窗口小部件就会定期递增此值的值。当前主题可以使用此选项来提供额外的动画效果.

ttk.Progressbar

class tkinter.ttk.Progressbar

start（interval=None）

开始自动增量模式：安排一个周期性的定时器事件，调用Progressbar.step()每interval毫秒。如果省略，interval默认为50毫秒.

step (amount=None )

如果省略，则将进度条的值增加amount.

amount默认为1.0。

stop（)

停止自动增量模式：取消由Progressbar.start()为此进度条启动的任何定期计时器事件.

继承的方法之外没有其他方法选项

这个小部件接受以下特定选项：

选项	说明
东方	“水平”或“垂直”之一。指定分隔符的方向.

特定于平台的笔记

• 在MacOS X上，顶层窗口自动包含内置大小的夹点默认。添加Sizegrip是无害的，因为内置的按钮只会掩盖小部件.

Bugs

• 如果相对于屏幕的右下角（例如……）指定了包含顶层的位置，则Sizegrip小部件将不会调整窗口的大小.
• 此小部件仅支持“东南”调整大小.

选项

这个小部件接受以下特定选项：

选项	描述
columns	列标识符列表，指定列数及其名称.
displaycolumns	列标识符（符号或整数索引）列表，指定哪些数据列aredisplay和它们出现的顺序，或字符串“#all”.
height	指定应该可见的行数。注意：请求的宽度由总和确定column widths.
padding	指定小部件的内部填充。Thepadding是一个最多四个长度规格的列表.
selectmode	控制内置类绑定如何管理选择。“扩展”，“浏览”或“无”之一。如果设置为“扩展”（默认），则可以选择多个项目。如果“浏览”，则一次只能选择一个项目。如果“无”，则选择不会改变. 注意应用程序代码和标签绑定可以随意设置选择，无论该选项的值如何.
show	包含以下零个或多个值的列表，指定要显示的树的哪些元素. tree：在＃0列中显示树标签. 标题：显示标题行. 默认为“树标题”，即显示等位元. 注意：列＃0总是指树列，即使show =“tree“未指定.

项目选项

可以为insert和itemwidget命令中的项目指定以下项目选项.

选项	描述
text	为项目显示的文字标签.
image	显示在标签左侧的Tk图像。
值	与item. 每个项目应具有与widgetoption列相同数量的值。如果值小于列，则假定其值为空。如果列的值更多，则忽略额外的值.
打开	真/假值表示该项目的孩子是否应该显示或隐藏.
tags	与此项目相关的标签列表.

Tag选项

可以在标签上指定以下选项：

选项	说明
前景	指定文本前景色.
background	指定单元格或项目背景颜色.
字体	指定绘制文本时使用的字体.
图片	指定项目图像，以防项目的图像选项为空.

列标识符

列标识符采用以下任何一种形式：

• 列列表中的符号名称option.
• 一个整数n，指定第n个数据列.
• 形式为#n的字符串，其中n是一个整数，指定第n个displaycolumn。

Notes:

• Item’s选项值的显示顺序可能与它们存储的顺序不同.
• Column＃0总是指树列，即使show =“tree”没有指定.

A数据列号是项目选项值列表的索引;显示列号是树中显示值的列号。树标签显示在＃0列中。如果未设置选项displaycolumns，则数据列n将显示在＃n + 1列中。同样，列＃0始终指向树列.

虚拟事件

Treeview小部件生成以下虚拟事件.

事件	描述
＆lt;＆lt; TreeviewSelect＆gt;＆gt;	每当选择改变时生成.
\u0026lt;\u0026lt;TreeviewOpen\u0026gt;\u0026gt;	Generated在设置之前，焦点项目打开=真.
\u0026lt;\u0026lt;TreeviewClose\u0026gt;\u0026gt;	将焦点项设置为open = False后生成.

Treeview.focus()和Treeview.selection()方法可用于确定受影响的项目.

ttk.Treeview

class tkinter.ttk.Treeview

bbox（item, column=None）

以（x，y，width，height）形式返回指定item的边界框（相对于树视图窗口小部件的窗口）.

如果指定了column，则返回该单元格的边界框。如果item是不可见的（即，如果它是一个封闭项目的后代或在屏幕外滚动），则返回一个空字符串.

get_children (item=None)

返回子项列表属于item.

如果item没有指定，返回root children.

set_children（item, *newchildren）

取代item有newchildren.

孩子们在场item中没有newchildren从树上下来。newchildren可能是item的祖先。注意，没有指定newchildren会导致item的孩子们分离.

column (column, option=None, **kw)

查询或修改选项指定column.

如果kw未给出，返回列选项值的dict。如果指定了option，则返回该option的值。否则，将选项设置为相应的值.

有效的选项/值为：

• id

  返回列名。这是一个只读选项.

• anchor：标准Tk锚值之一.

  指定此列中的文本应如何与单元格对齐.

• max width：width

  列的最小宽度（以像素为单位）。当窗口小部件调整大小或用户拖动列时，树视图窗口小部件不会使列小于此选项指定的列.

• stretch：True / False

  指定在调整小部件大小时是否应调整列的宽度.

• width：width

  列的宽度，以像素为单位.

要配置树列，请使用column =“＃0”

delete（*items）

删除所有指定的items及其所有后代.

根项不能删除.

detach (*items )

取消链接所有指定的items从树上

这些物品及其所有后代仍然存在，可以在树的另一个地方重新插入，但不会显示.

根项目可能不会分离.

exists (item)

如果指定的True存在于树中，则返回item。

focus（item=None）

如果指定了item，则将焦点项设置为item。否则，返回当前焦点项目，或“如果没有。”

heading（column, option=None, **kw)

查询或修改指定的标题选项column.

如果kw未给出，返回标题选项值的字典。如果指定了option，则返回该option的值。否则，将选项设置为相应的值.

有效的选项/值是：

• text：text

  列标题中显示的文本.

• image：imageName

  指定图像到显示在列标题的右侧.

• anchor：anchor

  指定标题文本的对齐方式。standardTk锚值之一.

• 命令：callback

  按下标题标签时要调用的回调.

要配置树列标题，请使用column =“＃0”调用它.

identify (component, x, y）

返回指定的component的描述x和y，或者如果没有这样的component，那就是空字符串

identify_row// (y)

返回位置上项目的商品ID y.

identify_column（x）

返回位置x.

的单元格的数据列标识符。树列有ID＃0 .

identify_region(x, y)

返回以下之一：

地区	含义
标题	树木标题区
分隔器	两列之间的空格标题
tree	树区
/	/数据单元

可用性：Tk 8.6.

identify_element (x, y)

返回位置x, y.

可用性：Tk 8.6.

index (item)

返回item在其父母的孩子名单中.

insert (parent, index, iid=None, **kw)

创建一个新项目并返回新创建项目的项目标识符.

parent是该项目父项的ID，或用于创建新顶级项的空字符串。index是一个整数，或者是值“end”，指定父项列表中插入新项的位置。如果index小于或等于零，则新节点为插入开始;如果index大于或等于当前的孩子数，则在最后插入。如果指定了iid，则将其用作项目标识符;iid必须不存在于树中。否则，会生成一个新的唯一标识符.

查看可用点列表的项目选项.

item (item, option=None, **kw）

查询或修改指定的item.

的选项如果没有给出选项，则返回带有项目选项/值的字典。如果option指定然后返回该选项的值。否则，将选项设置为kw.

move（item, parent, index）

给出的相应值//移动item在index中定位parent孩子的名单.

在其中一个后代下移动物品是违法的。如果index不等于或等于零，item被移到了开头;大于或等于子的数量，它被移动到最后。如果item被拆卸，则重新连接.

next (item)

返回item下一个兄弟姐妹，或”如果item是其父母的最后一个孩子.

parent（item）

返回item， 或者如果 item是在层次结构的顶层.

prev（item）

返回item以前的兄弟姐妹的标识符，或”如果item是其父母的第一个孩子.

reattach(item, parent, index)

Treeview.move().

see（item）的别名

确保item可见.

将item的所有祖先打开选项设置为True，并在必要时滚动窗口，以便item位于树的可见部分内.

selection（selop=None, items=None）

如果selop未指定，返回所选项目。否则，按照以下选择方法进行操作.

自版本3.6以来删除，将在3.8版本中删除：使用selection()不推荐用于更改选择状态。请改用以下选择方法.

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的当前值。使用三个参数，将给定column中给定的item的值设置为指定的value.

tag_bind（tagname, sequence=None, callback=None）

将给定事件sequence的回调绑定到标签tagname。当一个事件被传递给一个项目时，每个theitem的标签选项的回调被调用.

tag_configure（tagname, option=None, **kw）

查询或修改指定的tagname.

的选项如果没有给出kw，则返回tagname的选项设置的dict。如果指定了option，则返回指定option的tagname。否则，将选项设置为给定的对应值tagname.

tag_has（tagname, item=None）

如果指定了item，则返回1或0，具体取决于是否指定item有给定的tagname。否则，返回具有指定标签的所有项目的列表.

可用性：Tk 8.6

xview（*args）

查询或修改树视图的水平位置.

yview（*args）

查询或修改树视图的垂直位置

Layouts

布局可以只是None，如果没有选项，或者是一个指定如何排列元素的选项。布局机制使用包几何管理器的简化版本：给定初始腔，每个元素分配一个包。有效选项/值为：

• side：whichside

  指定放置元素的腔的哪一侧;一个顶部，右侧，底部或左侧。如果省略，则元素占据整个空洞.

• sticky：nswe

  指定元素放置在其分配的包裹内的位置.

• 单位：0或1

  如果设置为1，则为了Widget.identify()等，将元素及其所有后代视为单个元素。它适用于带有把手的滚动条拇指.

• children：[sublayout …]

  指定放置在元素内的元素列表。Eachelement是一个元组（或其他序列类型），其中第一个项目是布局名称，另一个是布局.