tkinter.ttk.Widget 简介

tkinter.ttk 模块提供对 Tk 8.5 中引入的 Tk 主题小部件集的访问。tkinter.ttk 的基本思想是，在可能的情况下，将实现小部件行为的代码与实现其外观的代码分开。使用新的窗口小部件的直接好处是可以在各个平台上提供更好的外观；但是，替换小部件并不完全兼容。主要区别在于 Ttk 小部件中不再提供小部件的部分选项，例如“fg”，“bg”以及其他与小部件样式相关的选项。相反，请使用 ttk.Style 类来改善样式效果。

ttk 中有 18 种部件 ，其中十二种已存在于 tkinter 中: Button, Checkbutton, Entry, Frame, Label, LabelFrame, Menubutton, PanedWindow, Radiobutton, Scale, Scrollbar 以及 Spinbox。 另外六种是新增的: Combobox, Notebook, Progressbar, Separator, Sizegrip 以及 Treeview。 它们全都是 ttk.Widget 的子类。

ttk.Widget 定义了由 Tk 主题部件所支持的标准选项和方法，它们不应该被直接实例化。

标准选项

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

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

可滚动控件选项

控件支持以下选项使用滚动条控制：

选项	描述
xscrollcommand	用于与水平滚动条通讯。当视图在控件的窗口改变，控件将会基于 scrollcommand 生成 Tcl 命令。通常，此选项由某些滚动条的 Scrollbar.set() 方法组成。每当窗口中的视图更改时，这将导致滚动条被更新。
yscrollcommand	用于与垂直滚动条通讯。

Label 选项

标签（labels），按钮和其他类似按钮的小部件均支持以下选项。

选项	描述
text	指定要在小部件内显示的文本字符串。
textvariable	指定一个名称，该名称的值将代替文本选项资源。
underline	如果设置，则指定要在文本字符串中加下划线的字符的索引（从0开始）。下划线字符用于助记符激活。
image	指定要显示的图像。这是一个或多个元素的列表。第一个元素是默认图像名称。列表的其余部分，如果是由 Style.map() 定义的一系列 statespec/value 对，则指定在小部件处于特定状态或状态组合时要使用的不同图像。列表中的所有图像应具有相同的尺寸。
compound	指定在同时显示文本和图像选项的情况下如何显示相对于文本的图像。
width	如果大于零，则指定要分配给文本标签的空间（以字符宽度为单位）；如果小于零，则指定最小宽度。如果为零或未指定，则使用文本标签的自然宽度。

compound的有效值为：

• text：只显示文本
• image: 只显示图片
• top, bottom, left, right: 分别显示图片的上,下,左,右的文本
• none: 默认. 如果设置显示图片, 否则文本

兼容性选项

选项	描述
state	可以设置为“normal”或“disabled”以控制“disabled”状态位。这是一个只写选项：设置它会更改小部件状态，但 Widget.state() 方法不会影响此选项。

Widget States

控件状态是独立状态标志的位图：

Flag	描述
active	鼠标光标在小部件上，按下鼠标按钮将引起一些动作
disabled	小部件在程序控制下被禁用
focus	小部件具有键盘焦点
pressed	小部件被按下
selected	“On”, “true”, or “current” for things like Checkbuttons and Radiobuttons
background	Windows 和 Mac具有“active”或前景窗口的概念。在后台窗口中为窗口小部件设置背景状态，并在前景窗口中为那些窗口小部件清除背景状态
readonly	小部件不应允许用户修改
alternate	特定于小部件的备用显示格式
invalid	小部件的值无效

状态规范是状态名称的序列，可以选择在其前面加上 ! 表示该位为 OFF。

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 通常是列表或元组。