"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()" 方法不影响本  |
   |          | 参数。                                                           |
   +----------+------------------------------------------------------------------+


控件状态
--------

控件状态是无关状态标志的位图.

   +--------------+---------------------------------------------------------------+
   | Flag         | 描述                                                          |
   |==============|===============================================================|
   | 活动         | 鼠标光标经过控件并按下鼠标按钮，将引发动作。                  |
   +--------------+---------------------------------------------------------------+
   | 禁用         | 在程序控制下控件是禁用的                                      |
   +--------------+---------------------------------------------------------------+
   | 焦点         | 控件有键盘焦点                                                |
   +--------------+---------------------------------------------------------------+
   | 按压         | 控件已被按下。                                                |
   +--------------+---------------------------------------------------------------+
   | 选择         | 勾选或单选框之类的控件，表示启用、选中状态。                  |
   +--------------+---------------------------------------------------------------+
   | 背景         | 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" 值。         |
+------------------------+--------------------------------------------------------+
| format                 | 字符串。指定递增/递减按钮的数字格式。必须以“%W.Pf”的格 |
|                        | 式给出，W 是填充 的宽度，P 是小数精度，% 和 f 就是本身 |
|                        | 的含义。                                               |
+------------------------+--------------------------------------------------------+
| 命令                   | Python 回调函数。只要递增或递减按钮按下之后，就会进行  |
|                        | 不带参数的调用。                                       |
+------------------------+--------------------------------------------------------+


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

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


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

class tkinter.ttk.Spinbox

   get()

      返回spinbox当前值

   set(value)

      设置spinbox的值为*value*.


笔记本
======

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
=========

"ttk.Separator" 控件用于显示横向或纵向的分隔条。

除由 "ttk.Widget" 继承而来的方法外，没有定义其他方法。


选项
----

属性如下：

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


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

      * 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* 的指定属性的动态值。

      *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 。
