"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" 小部件接受以下选项：

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


可滚动控件选项
--------------

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

   +------------------+-----------------------------------------------------------+
   | 选项             | 描述                                                      |
   |==================|===========================================================|
   | 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>>** 虚拟事件。


ttk.Combobox
------------

class tkinter.ttk.Combobox

   current(newindex=None)

      如果给出了 *newindex*，则把控件值设为 *newindex* 位置的元素值。
      否则，返回当前值的索引，当前值未在列表中则返回 -1。

   get()

      返回控件的当前值。

   set(value)

      设置控件的值为 *value* 。


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" 中都
有介绍。


选项
----

控件可设置以下参数：

+------------------------+--------------------------------------------------------+
| 选项                   | 描述                                                   |
|========================|========================================================|
| 从                     | 浮点值。即递减按钮要递减的最小值。作为参数使用时必须写 |
|                        | 成 "from_"，因为 "from" 是 Python 关键字。             |
+------------------------+--------------------------------------------------------+
| 到                     | 浮点值。即递增按钮能够到达的最大值。                   |
+------------------------+--------------------------------------------------------+
| 增加                   | 浮点值。指定递增/递减按钮每次的修改量。默认值为 1.0。  |
+------------------------+--------------------------------------------------------+
| 值                     | 字符串或浮点值构成的序列。如若给出，则递增/递减会在此  |
|                        | 序列元素间循环， 而不是增减数值。                      |
+------------------------+--------------------------------------------------------+
| wrap                   | 布尔值。若为 "True" ，则递增和递减按钮会由 "to" 值循环 |
|                        | 至 "from" 值，或 由  "from" 值循环至 "to" 值。         |
+------------------------+--------------------------------------------------------+
| 格式                   | 字符串。指定递增/递减按钮的数字格式。必须以“%W.Pf”的格 |
|                        | 式给出，W 是填充 的宽度，P 是小数精度，% 和 f 就是本身 |
|                        | 的含义。                                               |
+------------------------+--------------------------------------------------------+
| 命令                   | Python 回调函数。只要递增或递减按钮按下之后，就会进行  |
|                        | 不带参数的调用。                                       |
+------------------------+--------------------------------------------------------+


虚拟事件
--------

用户若按下 <Up> ，则控件会生成 **<<Increment>>** 虚拟事件，若按下
<Down> 则会生成 **<<Decrement>>** 事件。


ttk.Spinbox
-----------

class tkinter.ttk.Spinbox

   get()

      返回spinbox当前值

   set(value)

      设置spinbox的值为*值*.


笔记本
======

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" 继承而来的方法外，没有定义其他方法。


选项
----

属性如下：

   +----------+------------------------------------------------------------------+
   | 选项     | 描述                                                             |
   |==========|==================================================================|
   | orient   | horizontal 或 vertical。指定分隔条的方向。                       |
   +----------+------------------------------------------------------------------+


Sizegrip
========

"ttk.Sizegrip" 控件允许用户通过按下并拖动控制柄来调整内部顶层窗口的大
小。

除由 "ttk.Widget" 继承的之外，没有其他属性和方法。


与平台相关的注意事项
--------------------

* On macOS, toplevel windows automatically include a built-in size
  grip by default. Adding a "Sizegrip" is harmless, since the built-in
  grip will just mask the widget.


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"
           指明列宽度是否应该在部件大小被改变时进行相应的调整。

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

      返回由选中项构成的元组。

      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* 的当前值。若带三个参数，则将 *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* 的指定属性的动态值。

      Each key in *kw* is an option and each value should be a list or
      a tuple (usually) containing statespecs grouped in tuples,
      lists, or some other preference. A statespec is a compound of
      one or more states and then a value.

      An example may make it more understandable:

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

      Note that the order of the (states, value) sequences for an
      option does matter, if the order is changed to "[('active',
      'blue'), ('pressed', 'red')]" in the foreground option, for
      example, the result would be a blue foreground when the widget
      were in active or pressed states.

   lookup(style, option, state=None, default=None)

      Returns the value specified for *option* in *style*.

      If *state* is specified, it is expected to be a sequence of one
      or more states. If the *default* argument is set, it is used as
      a fallback value in case no specification for option is found.

      To check what font a Button uses by default:

         from tkinter import ttk

         print(ttk.Style().lookup("TButton", "font"))

   layout(style, layoutspec=None)

      Define the widget layout for given *style*. If *layoutspec* is
      omitted, return the layout specification for given style.

      *layoutspec*, if specified, is expected to be a list or some
      other sequence type (excluding strings), where each item should
      be a tuple and the first item is the layout name and the second
      item should have the format described in Layouts.

      To understand the format, see the following example (it is not
      intended to do anything useful):

         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)

      Create a new element in the current theme, of the given *etype*
      which is expected to be either "image", "from" or "vsapi". The
      latter is only available in Tk 8.6a for Windows XP and Vista and
      is not described here.

      If "image" is used, *args* should contain the default image name
      followed by statespec/value pairs (this is the imagespec), and
      *kw* may have the following options:

         * border=padding
              padding is a list of up to four integers, specifying the
              left, top, right, and bottom borders, respectively.

         * height=height
              Specifies a minimum height for the element. If less than
              zero, the base image's height is used as a default.

         * padding=padding
              Specifies the element's interior padding. Defaults to
              border's value if not specified.

         * sticky=spec
              Specifies how the image is placed within the final
              parcel. spec contains zero or more characters "n", "s",
              "w", or "e".

         * width=width
              Specifies a minimum width for the element. If less than
              zero, the base image's width is used as a default.

      If "from" is used as the value of *etype*, "element_create()"
      will clone an existing element. *args* is expected to contain a
      themename, from which the element will be cloned, and optionally
      an element to clone from. If this element to clone from is not
      specified, an empty element will be used. *kw* is discarded.

   element_names()

      Returns the list of elements defined in the current theme.

   element_options(elementname)

      Returns the list of *elementname*'s options.

   theme_create(themename, parent=None, settings=None)

      Create a new theme.

      It is an error if *themename* already exists. If *parent* is
      specified, the new theme will inherit styles, elements and
      layouts from the parent theme. If *settings* are present they
      are expected to have the same syntax used for
      "theme_settings()".

   theme_settings(themename, settings)

      Temporarily sets the current theme to *themename*, apply
      specified *settings* and then restore the previous theme.

      Each key in *settings* is a style and each value may contain the
      keys 'configure', 'map', 'layout' and 'element create' and they
      are expected to have the same format as specified by the methods
      "Style.configure()", "Style.map()", "Style.layout()" and
      "Style.element_create()" respectively.

      As an example, let's change the Combobox for the default theme a
      bit:

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

      Returns a list of all known themes.

   theme_use(themename=None)

      If *themename* is not given, returns the theme in use.
      Otherwise, sets the current theme to *themename*, refreshes all
      widgets and emits a <<ThemeChanged>> event.


Layouts
-------

A layout can be just "None", if it takes no options, or a dict of
options specifying how to arrange the element. The layout mechanism
uses a simplified version of the pack geometry manager: given an
initial cavity, each element is allocated a parcel. Valid
options/values are:

   * side: whichside
        Specifies which side of the cavity to place the element; one
        of top, right, bottom or left. If omitted, the element
        occupies the entire cavity.

   * sticky: nswe
        Specifies where the element is placed inside its allocated
        parcel.

   * unit: 0 or 1
        If set to 1, causes the element and all of its descendants to
        be treated as a single element for the purposes of
        "Widget.identify()" et al. It's used for things like scrollbar
        thumbs with grips.

   * children: [sublayout... ]
        Specifies a list of elements to place inside the element. Each
        element is a tuple (or other sequence type) where the first
        item is the layout name, and the other is a Layout.
