tkinter.ttk — Tk themed widgets

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

Compatibility Options(兼容性选项)

Widget States

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

状态规范是一系列状态名称，可选地带有一个感叹号，表示该位已关闭。

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)

测试小部件的状态。如果未指定callback，True 则在窗口小部件状态与statespec匹配时返回，False否则返回。如果指定了callback，那么如果widget状态与statespec匹配，则使用args调用它 。

state(statespec=None)

修改或查询小部件状态。如果指定了statespec，则根据它设置窗口小部件状态并返回指示哪些标志已更改的新状态规范。如果未指定statespec，则返回当前启用的状态标志。

statespec通常是列表或元组。

Combobox

该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中描述。

Options

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

虚拟事件

当用户从值列表中选择元素时，组合框小部件生成<< ComboboxSelected >>虚拟事件。

ttk.Combobox

class tkinter.ttk.Combobox

current（newindex =None）

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

get（）

返回组合框的当前值。

set（value）

　　Sets the value of the combobox to value.

Spinbox

该ttk.Spinbox窗口小部件是一个ttk.Entry增强版，用箭头增大或减小值。它可以用于数字或字符串值列表。这个小部件是Entry的子类。

除了从继承与Widget的方法：Widget.cget()， Widget.configure()，Widget.identify()，Widget.instate() 和Widget.state()，还有继承Entry的方法： Entry.bbox()，Entry.delete()，Entry.icursor()， Entry.index()，Entry.insert()，Entry.xview()，它有一些其他的方法，描述在ttk.Spinbox。

Options

虚拟事件

当用户按下<Up>时，spinbox小部件会生成<< Increment >>虚拟事件，当用户按下<Down>时，会生成<< Decrement >>虚拟事件。

ttk.Spinbox

class tkinter.ttk.Spinbox

　　get（）

　　返回spinbox的当前值。

　　set（value）

　　　　将spinbox的值设置为value

Notebook

　　Ttk Notebook小部件管理一组窗口并一次显示一个窗口。每个子窗口与选项卡相关联，用户可以选择该选项卡以更改当前显示的窗口。

Options

　　此小部件接受以下特定Options：

Tab Options

标签还有特定选项：

Tab Identifiers

ttk.Notebook的tab_id ，可以采用以下任何一种形式：

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

Virtual Events

选中新选项卡后，此小组件将生成<< NotebookTabChanged >>虚拟事件。

ttk.Notebook

class tkinter.ttk.Notebook

add(child, **kw)

在 notebook中添加新选项卡

如果窗口当前被 notebook 管理但被影藏,则会恢复到之前的位置。

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

forget(tab_id)

删除tab_id指定的选项卡，取消映射并取消管理关联的窗口。

hide(tab_id)

隐藏tab_id指定的选项卡。

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

identify(x, y)

返回位置x，y处的Tab的名称，如果没有，则返回空字符串。

index(tab_id)

返回tab_id指定的选项卡的数字索引，如果tab_id是字符串“end” ，则返回选项卡的总数。

insert(pos, child, **kw)

在指定位置插入 pane

pos是字符串“end”，整数索引或托管子项的名称。如果child已经由netbook管理，则将其移动到指定位置。

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

select(tab_id=None)

选择指定的tab_id。

将显示关联的子窗口，并且取消映射先前选择的窗口（如果不同）。如果省略tab_id，则返回当前所选窗格的窗口小部件名称。

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

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

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

tabs()

返回 notebook管理的窗口列表。

enable_traversal()

为包含此notebook的顶层窗口启用键盘遍历。

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

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

可以为单个顶层中的多个notebook启用遍历，包括嵌套notebook。但是，如果所有窗格都具有作为主窗口的notebook，notebook遍历才能正常工作。