ttk.Treeview

TTK的目的。

TreeView控件的呈现层次结构，用户可以使用鼠标动作来显示或隐藏结构的任何部分。

与术语“树”的关联是由于编程实践：树结构是一个常见的程序设计。严格地说，在一个TreeView控件显示的层次结构是一个森林：没有一个根，只是一个收集的顶级节点，每个可能包含二级节点，每个节点可以包含第三级，等等。

您可能已经遇到了这个特定的演示文稿作为浏览目录或文件夹层次结构的一种方式。整个层次结构显示像一个锯齿状的轮廓，其中每个目录是一个单独的行，并显示每个目录的子目录下面，缩进：

用户可以点击一个目录的图标崩溃（关闭）它，隐藏在它的所有项目。他们也可以再次点击图标来展开（打开）它，以便目录或文件夹中的项目被显示出来。

yòng用   hù户   kě可   yǐ以   diǎn点   jī击   yī一   gè个   mù目   lù录   de的   tú图   biāo标   bēng崩   kuì溃   （   guān关   bì闭   ）   tā它   ，   yǐn隐   cáng藏   zài在   tā它   de的   suǒ所   yǒu有   xiàng项   mù目   。   tā他   men们   yě也   kě可   yǐ以   zài再   cì次   diǎn点   jī击   tú图   biāo标   lái来   zhǎn展   kāi开   （   dǎ打   kāi开   ）   tā它   ，   yǐ以   biàn便   mù目   lù录   huò或   wén文   jiàn件   jiā夹   zhōng中   de的   xiàng项   mù目   bèi被   xiǎn显   shì示   chū出   lái来   。

The Treeview widget generalizes this concept so that you can use it to display any hierarchical structure, and the reader can collapse or expand subtrees of this structure with the mouse.

的TreeView控件的推广这个概念，你可以用它来显示任何层次结构，和读者可以折叠或展开这一结构子树与鼠标。

de的   T   r   e   e   V   i   e   w   kòng控   jiàn件   de的   tuī推   guǎng广   zhè这   ge个   gài概   niàn念   ，   nǐ你   kě可   yǐ以   yòng用   tā它   lái来   xiǎn显   shì示   rèn任   hé何   céng层   cì次   jié结   gòu构   ，   hé和   dú读   zhě者   kě可   yǐ以   zhé折   dié叠   huò或   zhǎn展   kāi开   zhè这   yī一   jié结   gòu构   zǐ子   shù树   yǔ与   shǔ鼠   biāo标   。

First, some definitions:

首先，一些定义：

shǒu首   xiān先   ，   yī一   xiē些   dìng定   yì义   ：

item

item

xiàng项   mù目

One of the entities being displayed in the widget. For a file browser, an item might be either a directory or a file.

正在显示的部件中的一个实体。对于一个文件浏览器，一个项目可能是一个目录或一个文件。

zhèng正   zài在   xiǎn显   shì示   de的   bù部   jiàn件   zhōng中   de的   yī一   gè个   shí实   tǐ体   。   duì对   yú于   yī一   gè个   wén文   jiàn件   liú浏   lǎn览   qì器   ，   yī一   gè个   xiàng项   mù目   kě可   néng能   shì是   yī一   gè个   mù目   lù录   huò或   yī一   gè个   wén文   jiàn件   。

Each item is associated with a textual label, and may also be associated with an image.

每个项目都与文本标签相关联的，也可以与图像相关联的。

měi每   gè个   xiàng项   mù目   dōu都   yǔ与   wén文   běn本   biāo标   qiān签   xiāng相   guān关   lián联   de的   ，   yě也   kě可   yǐ以   yǔ与   tú图   xiàng像   xiāng相   guān关   lián联   de的   。

iid

IID

I   I   D

Every item in the tree has a unique identifier string called the iid. You can supply the iid values yourself, or you can let ttk generate them.

在树的每一个项目都有一个唯一的标识符字符串称为IID。你们能提供的IID值你自己，或者你可以让这些生成。

zài在   shù树   de的   měi每   yī一   gè个   xiàng项   mù目   dōu都   yǒu有   yī一   gè个   wéi唯   yī一   de的   biāo标   shí识   fú符   zì字   fú符   chuàn串   chēng称   wéi为   I   I   D   。   nǐ你   men们   néng能   tí提   gōng供   de的   I   I   D   zhí值   nǐ你   zì自   jǐ己   ，   huò或   zhě者   nǐ你   kě可   yǐ以   ràng让   zhè这   xiē些   shēng生   chéng成   。

child

child

xiǎo小   hái孩

The items directly below a given item in a hierarchy. A directory, for example, may have two kinds of children: files and subdirectories.

在层次结构中的一个给定项目下的项目。例如，一个目录，，可能有两种孩子：文件和子目录。

zài在   céng层   cì次   jié结   gòu构   zhōng中   de的   yī一   gè个   gěi给   dìng定   xiàng项   mù目   xià下   de的   xiàng项   mù目   。   lì例   rú如   ，   yī一   gè个   mù目   lù录   ，   ，   kě可   néng能   yǒu有   liǎng两   zhǒng种   hái孩   zi子   ：   wén文   jiàn件   hé和   zǐ子   mù目   lù录   。

parent

parent

qǐ起   yuán源

For a given item, if it is at the top of the hierarchy it is said to have no parent; if it is not at the top level, the parent is the item that contains it.

对于一个给定的项目，如果它是在层次结构的顶部，它被称为没有父；如果它不是在顶层，父是包含它的项目。

duì对   yú于   yī一   gè个   gěi给   dìng定   de的   xiàng项   mù目   ，   rú如   guǒ果   tā它   shì是   zài在   céng层   cì次   jié结   gòu构   de的   dǐng顶   bù部   ，   tā它   bèi被   chēng称   wéi为   méi没   yǒu有   fù父   ；   rú如   guǒ果   tā它   bù不   shì是   zài在   dǐng顶   céng层   ，   fù父   shì是   bāo包   hán含   tā它   de的   xiàng项   mù目   。

ancestor

ancestor

zǔ祖   xiān先

The ancestors of an item include its parent, its parent's parent, and so on up to the top level of the tree.

一个项目的祖先包括它的父母，它的父母的父母，所以在树的最高水平。

yī一   gè个   xiàng项   mù目   de的   zǔ祖   xiān先   bāo包   kuò括   tā它   de的   fù父   mǔ母   ，   tā它   de的   fù父   mǔ母   de的   fù父   mǔ母   ，   suǒ所   yǐ以   zài在   shù树   de的   zuì最   gāo高   shuǐ水   píng平   。

visible

visible

kàn看   de得   jiàn见   de的

Top-level items are always visible. Otherwise, an item is visible only if all its ancestors are expanded.

顶层项目总是可见的。否则，只有当所有的祖先都被扩展时，一个项目是可见的。

dǐng顶   céng层   xiàng项   mù目   zǒng总   shì是   kě可   jiàn见   de的   。   fǒu否   zé则   ，   zhǐ只   yǒu有   dāng当   suǒ所   yǒu有   de的   zǔ祖   xiān先   dōu都   bèi被   kuò扩   zhǎn展   shí时   ，   yī一   gè个   xiàng项   mù目   shì是   kě可   jiàn见   de的   。

descendant

descendant

hòu后   yì裔

The descendants of an item include its children, its childrens' children, and so on. Another way of saying this is that the subtree of an item includes all its descendants.

一个项目的后代包括它的孩子，它的孩子的孩子，等等。另一种说法是，一个项目的子树包含所有它的后代。

yī一   gè个   xiàng项   mù目   de的   hòu后   dài代   bāo包   kuò括   tā它   de的   hái孩   zi子   ，   tā它   de的   hái孩   zi子   de的   hái孩   zi子   ，   děng等   děng等   。   lìng另   yī一   zhǒng种   shuō说   fǎ法   shì是   ，   yī一   gè个   xiàng项   mù目   de的   zǐ子   shù树   bāo包   hán含   suǒ所   yǒu有   tā它   de的   hòu后   dài代   。

tag

tag

biāo标   qiān签

Your program can associate one or more tag strings with each item. You can use these tags to control the appearance of an item. For example, you could tag directories with the tag 'd' and files with the tag 'f', and then specify that items with tag 'd' use a boldface font.

您的程序可以将一个或多个标记字符串与每个项目关联。您可以使用这些标签来控制项目的外观。例如，你可以使用标签的“D”和“F”文件的标签标签的目录，然后指定物品的标签“D”用黑体字体。

nín您   de的   chéng程   xù序   kě可   yǐ以   jiāng将   yī一   gè个   huò或   duō多   gè个   biāo标   jì记   zì字   fú符   chuàn串   yǔ与   měi每   gè个   xiàng项   mù目   guān关   lián联   。   nín您   kě可   yǐ以   shǐ使   yòng用   zhè这   xiē些   biāo标   qiān签   lái来   kòng控   zhì制   xiàng项   mù目   de的   wài外   guān观   。   lì例   rú如   ，   nǐ你   kě可   yǐ以   shǐ使   yòng用   biāo标   qiān签   de的   “   D   ”   hé和   “   F   ”   wén文   jiàn件   de的   biāo标   qiān签   biāo标   qiān签   de的   mù目   lù录   ，   rán然   hòu后   zhǐ指   dìng定   wù物   pǐn品   de的   biāo标   qiān签   “   D   ”   yòng用   hēi黑   tǐ体   zì字   tǐ体   。

You may also associate events with tags, so that certain events will cause certain handlers to be called for all items that have that tag. For example, you could set up a file browser so that when a user clicks on a directory, the browser updated its contents to reflect the current file structure.

您也可以将事件与标签关联，以便某些事件将导致某些处理程序被调用具有该标记的所有项目。例如，您可以设置一个文件浏览器，以便当用户点击一个目录时，浏览器更新其内容以反映当前的文件结构。

nín您   yě也   kě可   yǐ以   jiāng将   shì事   jiàn件   yǔ与   biāo标   qiān签   guān关   lián联   ，   yǐ以   biàn便   mǒu某   xiē些   shì事   jiàn件   jiāng将   dǎo导   zhì致   mǒu某   xiē些   chǔ处   lǐ理   chéng程   xù序   bèi被   diào调   yòng用   jù具   yǒu有   gāi该   biāo标   jì记   de的   suǒ所   yǒu有   xiàng项   mù目   。   lì例   rú如   ，   nín您   kě可   yǐ以   shè设   zhì置   yī一   gè个   wén文   jiàn件   liú浏   lǎn览   qì器   ，   yǐ以   biàn便   dāng当   yòng用   hù户   diǎn点   jī击   yī一   gè个   mù目   lù录   shí时   ，   liú浏   lǎn览   qì器   gēng更   xīn新   qí其   nèi内   róng容   yǐ以   fǎn反   yìng映   dāng当   qián前   de的   wén文   jiàn件   jié结   gòu构   。

Your Treeview widget will be structured with multiple columns. The first column, which we'll call the icon column, displays the icons that collapse or expand items. In the remaining columns, you may display whatever information you like.

你的TreeView控件的结构将与多个列。我们将称为“图标”列的第一列，显示折叠或展开项目的图标。在剩下的栏目中，你可以展示你喜欢的任何信息。

nǐ你   de的   T   r   e   e   V   i   e   w   kòng控   jiàn件   de的   jié结   gòu构   jiāng将   yǔ与   duō多   gè个   liè列   。   wǒ我   men们   jiāng将   chēng称   wéi为   “   tú图   biāo标   ”   liè列   de的   dì第   yī一   liè列   ，   xiǎn显   shì示   zhé折   dié叠   huò或   zhǎn展   kāi开   xiàng项   mù目   de的   tú图   biāo标   。   zài在   shèng剩   xià下   de的   lán栏   mù目   zhōng中   ，   nǐ你   kě可   yǐ以   zhǎn展   shì示   nǐ你   xǐ喜   huan欢   de的   rèn任   hé何   xìn信   xī息   。

For example, a simple file browser widget might use two columns, with the directory icons in the first column and the directory or file name in the second columns. Or you might wish to display file sizes, permissions, and other related data in additional columns.

例如，一个简单的文件浏览器组件可能使用两个列，在第一列中的目录图标和第二列中的目录或文件名。或者您可能希望显示其他列的文件大小、权限和其他相关数据。

lì例   rú如   ，   yī一   gè个   jiǎn简   dān单   de的   wén文   jiàn件   liú浏   lǎn览   qì器   zǔ组   jiàn件   kě可   néng能   shǐ使   yòng用   liǎng两   gè个   liè列   ，   zài在   dì第   yī一   liè列   zhōng中   de的   mù目   lù录   tú图   biāo标   hé和   dì第   èr二   liè列   zhōng中   de的   mù目   lù录   huò或   wén文   jiàn件   míng名   。   huò或   zhě者   nín您   kě可   néng能   xī希   wàng望   xiǎn显   shì示   qí其   tā他   liè列   de的   wén文   jiàn件   dà大   xiǎo小   、   quán权   xiàn限   hé和   qí其   tā他   xiāng相   guān关   shù数   jù据   。

The operations of the Treeview widget even allow you to use it as a tree editor. Your program can remove an entire subtree from its location in the main tree and then attach it later at an entirely different point.

在TreeView控件的操作，甚至允许你使用它作为一个树编辑。你的程序可以删除整个子树从它的位置在主树，然后将它之后在一个完全不同的角度。

zài在   T   r   e   e   V   i   e   w   kòng控   jiàn件   de的   cāo操   zuò作   ，   shèn甚   zhì至   yǔn允   xǔ许   nǐ你   shǐ使   yòng用   tā它   zuò作   wéi为   yī一   gè个   shù树   biān编   jí辑   。   nǐ你   de的   chéng程   xù序   kě可   yǐ以   shān删   chú除   zhěng整   gè个   zǐ子   shù树   cóng从   tā它   de的   wèi位   zhi置   zài在   zhǔ主   shù树   ，   rán然   hòu后   jiāng将   tā它   zhī之   hòu后   zài在   yī一   gè个   wán完   quán全   bù不   tóng同   de的   jiǎo角   dù度   。

Here is the general procedure for setting up a Treeview widget.

这里是设置TreeView控件的一般程序。

zhè这   lǐ里   shì是   shè设   zhì置   T   r   e   e   V   i   e   w   kòng控   jiàn件   de的   yī一   bān般   chéng程   xù序   。

1. Create the widget with the ttk.Treeview constructor. Use the columns keyword argument to specify the number of columns to be displayed and to assign symbolic names to each column.

1。创建TTK TreeView的构造函数的部件。使用列关键字参数来指定要显示的列数，并为每个列分配符号名。

1   。   chuàng创   jiàn建   T   T   K   T   r   e   e   V   i   e   w   de的   gòu构   zào造   hán函   shù数   de的   bù部   jiàn件   。   shǐ使   yòng用   liè列   guān关   jiàn键   zì字   cān参   shù数   lái来   zhǐ指   dìng定   yào要   xiǎn显   shì示   de的   liè列   shǔ数   ，   bìng并   wèi为   měi每   gè个   liè列   fēn分   pèi配   fú符   hào号   míng名   。

2. Use the .column() and .heading() methods to set up column headings (if you want them) and configure column properties such as size and stretchability.

2。使用。column()和。heading()方法设置列标题（如果你想）和配置列属性如大小和拉伸性。

2   。   shǐ使   yòng用   。   c   o   l   u   m   n   (   )   hé和   。   h   e   a   d   i   n   g   (   )   fāng方   fǎ法   shè设   zhì置   liè列   biāo标   tí题   （   rú如   guǒ果   nǐ你   xiǎng想   ）   hé和   pèi配   zhì置   liè列   shǔ属   xìng性   rú如   dà大   xiǎo小   hé和   lā拉   shēn伸   xìng性   。

3. Starting with the top-level entries, use the .insert() method to populate the tree. Each call to this method adds one item to the tree. Use the open keyword argument of this method to specify whether the item is initially expanded or collapsed.

三.从顶层的条目，使用方法。insert()填充树。每个对该方法的调用将一个项目添加到树中。使用此方法的打开关键字参数来指定项目是否最初是扩展或折叠的。

sān三   .   cóng从   dǐng顶   céng层   de的   tiáo条   mù目   ，   shǐ使   yòng用   fāng方   fǎ法   。   i   n   s   e   r   t   (   )   tián填   chōng充   shù树   。   měi每   gè个   duì对   gāi该   fāng方   fǎ法   de的   diào调   yòng用   jiāng将   yī一   gè个   xiàng项   mù目   tiān添   jiā加   dào到   shù树   zhōng中   。   shǐ使   yòng用   cǐ此   fāng方   fǎ法   de的   dǎ打   kāi开   guān关   jiàn键   zì字   cān参   shù数   lái来   zhǐ指   dìng定   xiàng项   mù目   shì是   fǒu否   zuì最   chū初   shì是   kuò扩   zhǎn展   huò或   zhé折   dié叠   de的   。

If you want to supply the iid value for this item, use the iid keyword argument. If you omit this argument, ttk will make one up and return it as the result of the .insert() method call.

如果你想为这个项目提供的ID值，使用IID关键字参数。如果省略此参数，将使一个TTK并返回它的结果。insert()方法调用。

rú如   guǒ果   nǐ你   xiǎng想   wèi为   zhè这   ge个   xiàng项   mù目   tí提   gōng供   de的   I   D   zhí值   ，   shǐ使   yòng用   I   I   D   guān关   jiàn键   zì字   cān参   shù数   。   rú如   guǒ果   shěng省   lvè略   cǐ此   cān参   shù数   ，   jiāng将   shǐ使   yī一   gè个   T   T   K   bìng并   fǎn返   huí回   tā它   de的   jié结   guǒ果   。   i   n   s   e   r   t   (   )   fāng方   fǎ法   diào调   yòng用   。

Use the values keyword argument of this method to specify what should appear in each column of this item when it is visible.

使用此方法的值关键字参数指定在该项目的每个列中应出现的什么时，它是可见的。

shǐ使   yòng用   cǐ此   fāng方   fǎ法   de的   zhí值   guān关   jiàn键   zì字   cān参   shù数   zhǐ指   dìng定   zài在   gāi该   xiàng项   mù目   dì的   měi每   gè个   liè列   zhōng中   yīng应   chū出   xiàn现   de的   shén什   me么   shí时   ，   tā它   shì是   kě可   jiàn见   de的   。

To create a Treeview widget within a given parent widget:

在一个给定的父控件创建一个TreeView控件：

w = ttk.Treeview(parent, option=value, ...)

构造函数返回新的TreeView控件。它的选项包括：

class_

当您创建这个小部件时，您可以提供一个小部件的名称。此名称可用于自定义小部件的外观；请参见第27节“标准外观”。一旦创建了小部件，则无法更改小部件的名称。

columns

列标识符字符串的序列。这些字符串在内部使用，以确定控件中的列。图标栏，其标识符总是“# 0”，包含折叠/展开的图标总是第一列。

liè列   biāo标   shí识   fú符   zì字   fú符   chuàn串   de的   xù序   liè列   。   zhè这   xiē些   zì字   fú符   chuàn串   zài在   nèi内   bù部   shǐ使   yòng用   ，   yǐ以   què确   dìng定   kòng控   jiàn件   zhōng中   de的   liè列   。   tú图   biāo标   lán栏   ，   qí其   biāo标   shí识   fú符   zǒng总   shì是   “   #   0   ”   ，   bāo包   hán含   zhé折   dié叠   /   zhǎn展   kāi开   de的   tú图   biāo标   zǒng总   shì是   dì第   yī一   liè列   。

The columns you specify with the columns argument are in addition to the icon column.

您指定的列参数的列除了图标列之外。

nín您   zhǐ指   dìng定   de的   liè列   cān参   shù数   de的   liè列   chú除   le了   tú图   biāo标   liè列   zhī之   wài外   。

For example, if you specified columns=('Name', 'Size'), three columns would appear in the widget: first the icon column, then two more columns whose internal identifiers are 'Name' and 'Size'.

例如，如果你指定的列=（'name'，'大小'），三列将出现在窗口的图标：第一列，然后两柱内部标识符的名称和大小。

cursor

使用该选项指定鼠标光标的外观，当它在窗口；参见5.8节，“光标”。指定的默认值（一个空字符串）指定从父控件继承的光标。

displaycolumns

选择实际上显示的列，并确定它们的演示文稿的顺序。价值观可能：

xuǎn选   zé择   shí实   jì际   shang上   xiǎn显   shì示   de的   liè列   ，   bìng并   què确   dìng定   tā它   men们   de的   yǎn演   shì示   wén文   gǎo稿   de的   shùn顺   xù序   。   jià价   zhí值   guān观   kě可   néng能   ：

• '#all' to select all columns and display them in the order defined by the columns argument.

•”#所有选择所有列的列参数定义的顺序显示。

•   ”   #   suǒ所   yǒu有   xuǎn选   zé择   suǒ所   yǒu有   liè列   de的   liè列   cān参   shù数   dìng定   yì义   de的   shùn顺   xù序   xiǎn显   shì示   。

• A list of column numbers (integer positions, counting from 0) or column identifiers from the columns argument.

A列数（整数的位置，从0计数）或列标识符从列参数列表。

A   liè列   shǔ数   （   zhěng整   shù数   de的   wèi位   zhi置   ，   cóng从   0   jì计   shù数   ）   huò或   liè列   biāo标   shí识   fú符   cóng从   liè列   cān参   shù数   liè列   biǎo表   。

For example, suppose you specify columns=('Name', 'Size', 'Date'). This means each call to the .insert() method will require an argument values=(name, size, date) to supply the values that will be displayed. Let's call this sequence the logical column sequence.

例如，假设你指定列=（'name'，'大小'，'日'）。这意味着每个电话。insert()方法需要一个参数值=（名称、大小、日期）提供的值将被显示。让我们将此序列称为“逻辑列”序列。

lì例   rú如   ，   jiǎ假   shè设   nǐ你   zhǐ指   dìng定   liè列   =   （   '   n   a   m   e   '   ，   '   dà大   xiǎo小   '   ，   '   rì日   '   ）   。   zhè这   yì意   wèi味   zhe着   měi每   gè个   diàn电   huà话   。   i   n   s   e   r   t   (   )   fāng方   fǎ法   xū需   yào要   yī一   gè个   cān参   shù数   zhí值   =   （   míng名   chēng称   、   dà大   xiǎo小   、   rì日   qī期   ）   tí提   gōng供   de的   zhí值   jiāng将   bèi被   xiǎn显   shì示   。   ràng让   wǒ我   men们   jiāng将   cǐ此   xù序   liè列   chēng称   wéi为   “   luó逻   jí辑   liè列   ”   xù序   liè列   。

Further suppose that in the constructor you specify columns=(2,0). The physical column sequence, the columns that will actually appear in the widget, will be three: the icon column will be first, followed by the date column (index 2 in the logical column sequence), followed by the name column (logical column index 0). The size column will not appear.

进一步假设你指定列=构造函数（2,0）。物理列的顺序，将实际出现在小部件中的列，将是三：图标列将是第一个，然后是数据列（逻辑列序列中的索引2），然后是“名称”列（逻辑列索引0）。大小列将不会出现。

jìn进   yī一   bù步   jiǎ假   shè设   nǐ你   zhǐ指   dìng定   liè列   =   gòu构   zào造   hán函   shù数   （   2   ,   0   ）   。   wù物   lǐ理   liè列   de的   shùn顺   xù序   ，   jiāng将   shí实   jì际   chū出   xiàn现   zài在   xiǎo小   bù部   jiàn件   zhōng中   de的   liè列   ，   jiāng将   shì是   sān三   ：   tú图   biāo标   liè列   jiāng将   shì是   dì第   yī一   gè个   ，   rán然   hòu后   shì是   shù数   jù据   liè列   （   luó逻   jí辑   liè列   xù序   liè列   zhōng中   de的   suǒ索   yǐn引   2   ）   ，   rán然   hòu后   shì是   “   míng名   chēng称   ”   liè列   （   luó逻   jí辑   liè列   suǒ索   yǐn引   0   ）   。   dà大   xiǎo小   liè列   jiāng将   bù不   huì会   chū出   xiàn现   。

You could get the same effect by specifying column identifiers instead of logical column positions: columns=('Date', 'Name').

你可以通过指定列的标识符，而不是逻辑列位置得到同样的效果：柱=（'date '，'名'）。

height

使用此参数可以将额外的空间放在小部件内部的内容周围。您可以提供一个单一的维度或一个高达四个维度的序列，根据本表解释：

Values given	Left	Top	Right	Bottom
a	a	a	a	a
a b	a	b	a	b
a b c	a	c	b	c
a b c d	a	b	c	d

selectmode

此选项可以控制用户允许使用鼠标选择什么。可以值：

selectmode='browse'	The user may select only one item at a time.
selectmode='extended'	The user may select multiple items at once.
selectmode='none'	The user cannot select items with the mouse.

show

抑制标签在每一列的顶部，指定显示=‘树’。默认是显示列标签。

style

使用此选项可以指定一个自定义控件样式名称；参见47节，“定制和创建TTK的主题和风格”。

takefocus

使用这个选项来指定一个小部件是否被访问在焦点遍历；见第53节，“焦点：路由键盘输入”。指定takefocus =真正的如果你想去接受焦点；指定takefocus =如果控件不接受焦点错误。默认值为空字符串；默认情况下，控件获得焦点的控件做的TTK。

这里有一个TreeView控件的使用方法。

zhè这   lǐ里   yǒu有   yī一   gè个   T   r   e   e   V   i   e   w   kòng控   jiàn件   de的   shǐ使   yòng用   fāng方   fǎ法   。

.bbox(item, column=None)

.bbox(item,column=None)

。   B   B   O   X   （   xiàng项   mù目   ，   liè列   =   méi没   yǒu有   ）

For the item with iid item, if the item is currently visible, this method returns a tuple (x, y, w, h), where (x, y) are the coordinates of the upper left corner of that item relative to the widget, and w and h are the width and height of the item in pixels. If the item is not visible, the method returns an empty string.

该项目的项目，如果该项目是目前可见的，此方法返回一个元组（X，Y，W，H），其中（x，y）是该项目的左上角的坐标相对于控件，和W和H是该项目的宽度和像素高度。如果该项目是不可见的，该方法返回一个空字符串。

gāi该   xiàng项   mù目   dì的   xiàng项   mù目   ，   rú如   guǒ果   gāi该   xiàng项   mù目   shì是   mù目   qián前   kě可   jiàn见   de的   ，   cǐ此   fāng方   fǎ法   fǎn返   huí回   yī一   gè个   yuán元   zǔ组   （   X   ，   Y   ，   W   ，   H   ）   ，   qí其   zhōng中   （   x   ，   y   ）   shì是   gāi该   xiàng项   mù目   dì的   zuǒ左   shàng上   jiǎo角   de的   zuò坐   biāo标   xiāng相   duì对   yú于   kòng控   jiàn件   ，   hé和   W   hé和   H   shì是   gāi该   xiàng项   mù目   dì的   kuān宽   dù度   hé和   xiàng像   sù素   gāo高   dù度   。   rú如   guǒ果   gāi该   xiàng项   mù目   shì是   bù不   kě可   jiàn见   de的   ，   gāi该   fāng方   fǎ法   fǎn返   huí回   yī一   gè个   kōng空   zì字   fú符   chuàn串   。

If the optional column argument is omitted, you get the bounding box of the entire row. To get the bounding box of one specific column of the item's row, use column=C where C is either the integer index of the column or its column identifier.

如果省略了可选的列参数，则将得到整个行的包围盒。要得到项目行的一个特定列的包围框，使用列= C，其中C是列的整数索引或它的列标识符。

rú如   guǒ果   shěng省   lvè略   le了   kě可   xuǎn选   de的   liè列   cān参   shù数   ，   zé则   jiāng将   dé得   dào到   zhěng整   gè个   xíng行   de的   bāo包   wéi围   hé盒   。   yào要   dé得   dào到   xiàng项   mù目   xíng行   de的   yī一   gè个   tè特   dìng定   liè列   de的   bāo包   wéi围   kuàng框   ，   shǐ使   yòng用   liè列   =   C   ，   qí其   zhōng中   C   shì是   liè列   de的   zhěng整   shù数   suǒ索   yǐn引   huò或   tā它   de的   liè列   biāo标   shí识   fú符   。

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

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

。   zhù柱   （   C   I   D   ，   xuǎn选   xiàng项   =   wú无   ，   ×   ×   qiān千   wǎ瓦   ）

This method configures the appearance of the logical column specified by cid, which may be either a column index or a column identifier. To configure the icon column, use a cid value of '#0'.

该方法配置指定的CID的逻辑列的外观，它可以是一个列的索引或列标识。配置图标栏，使用CID值“0”#。

gāi该   fāng方   fǎ法   pèi配   zhì置   zhǐ指   dìng定   de的   C   I   D   de的   luó逻   jí辑   liè列   de的   wài外   guān观   ，   tā它   kě可   yǐ以   shì是   yī一   gè个   liè列   de的   suǒ索   yǐn引   huò或   liè列   biāo标   shí识   。   pèi配   zhì置   tú图   biāo标   lán栏   ，   shǐ使   yòng用   C   I   D   zhí值   “   0   ”   #   。

Each column in a Treeview widget has its own set of options from this table:

在TreeView控件的每个列都有其选择自己从这个表：

anchor	The anchor that                    specifies where to position the content of the                    column.  The default value is 'w'.
id	The column name.  This option is read-only and                    set when the constructor is called.
minwidth	Minimum width of the column in pixels; the default                    value is 20.
stretch	If this option is True, the                    column's width will be adjusted when the widget is                    resized.  The default setting is 1.
width	Initial width of the column in pixels; the default                    is 200.

如果提供了没有选项值或任何其他关键字参数，则该方法将返回指定列的列选项的字典。

rú如   guǒ果   tí提   gōng供   le了   méi没   yǒu有   xuǎn选   xiàng项   zhí值   huò或   rèn任   hé何   qí其   tā他   guān关   jiàn键   zì字   cān参   shù数   ，   zé则   gāi该   fāng方   fǎ法   jiāng将   fǎn返   huí回   zhǐ指   dìng定   liè列   de的   liè列   xuǎn选   xiàng项   de的   zì字   diǎn典   。

• To interrogate the current value of an option named X , use an argument option=X.

•审问的一个选项，命名为x的当前值，使用一个参数选项= x。

•   shěn审   wèn问   de的   yī一   gè个   xuǎn选   xiàng项   ，   mìng命   míng名   wéi为   x   de的   dāng当   qián前   zhí值   ，   shǐ使   yòng用   yī一   gè个   cān参   shù数   xuǎn选   xiàng项   =   x   。

• To set one or more column options, you may pass keyword arguments using the option names shown above, e.g., anchor=tk.CENTER to center the column contents.

•设置一个或多个列的选项，你可以通过关键字参数使用上面显示的选项名称如锚= tk.center中心栏目内容。

.delete(*items)

参数是IID值。在有匹配的IID值部件的所有项目都被摧毁了，连同他们的后代。

.detach(*items)

参数是IID值。在有匹配的IID值的控件的所有物品都是从可见的部件拆下，连同他们的后代。

cān参   shù数   shì是   I   I   D   zhí值   。   zài在   yǒu有   pǐ匹   pèi配   de的   I   I   D   zhí值   de的   kòng控   jiàn件   de的   suǒ所   yǒu有   wù物   pǐn品   dōu都   shì是   cóng从   kě可   jiàn见   de的   bù部   jiàn件   chāi拆   xià下   ，   lián连   tóng同   tā他   men们   de的   hòu后   dài代   。

The items are not destroyed. You may reattach them to the visible tree using the .move() method described below.

项目没有被销毁。你可以将它们用可见树move()下面描述的方法。

.exists(iid)

返回true，如果存在一个项目中的控件与给定的IID，否则。如果一个项目不可见因为它被删除的。detach()方法，它仍然被认为是为这个目的而存在。exists()方法。

.focus([iid])

如果你不为这个方法提供了一种说法，你回来或者物品的IID当前具有焦点，或“如果没有项目有焦点。

rú如   guǒ果   nǐ你   bù不   wèi为   zhè这   ge个   fāng方   fǎ法   tí提   gōng供   le了   yī一   zhǒng种   shuō说   fǎ法   ，   nǐ你   huí回   lái来   huò或   zhě者   wù物   pǐn品   de的   I   I   D   dāng当   qián前   jù具   yǒu有   jiāo焦   diǎn点   ，   huò或   “   rú如   guǒ果   méi没   yǒu有   xiàng项   mù目   yǒu有   jiāo焦   diǎn点   。

You can give focus to an item by passing its iid as the argument to this method.

你可以通过其IID作为参数传递给这个方法一个项目给予重点。

.get_children([item])

返回一个元组的儿童项目的项目参数指定的ID值。如果省略该参数，你会得到一个元组包含顶级项目的IID值。

fǎn返   huí回   yī一   gè个   yuán元   zǔ组   de的   ér儿   tóng童   xiàng项   mù目   de的   xiàng项   mù目   cān参   shù数   zhǐ指   dìng定   de的   I   D   zhí值   。   rú如   guǒ果   shěng省   lvè略   gāi该   cān参   shù数   ，   nǐ你   huì会   dé得   dào到   yī一   gè个   yuán元   zǔ组   bāo包   hán含   dǐng顶   jí级   xiàng项   mù目   de的   I   I   D   zhí值   。

.heading(cid, option=None, **kw)

。标题（CID，选项=无，××千瓦）

。   biāo标   tí题   （   C   I   D   ，   xuǎn选   xiàng项   =   wú无   ，   ×   ×   qiān千   wǎ瓦   ）

Use this method to configure the column heading that appears at the top of the widget for the column specified by cid, which may be either a column index or a column identifier. Use a cid argument value of '#0' to configure the heading over the icon column.

使用此方法可以配置在指定的CID柱部件的顶部显示的列标题，可以是一个列的索引或列标识。使用CID参数值“0”#配置标题在图标栏。

shǐ使   yòng用   cǐ此   fāng方   fǎ法   kě可   yǐ以   pèi配   zhì置   zài在   zhǐ指   dìng定   de的   C   I   D   zhù柱   bù部   jiàn件   de的   dǐng顶   bù部   xiǎn显   shì示   de的   liè列   biāo标   tí题   ，   kě可   yǐ以   shì是   yī一   gè个   liè列   de的   suǒ索   yǐn引   huò或   liè列   biāo标   shí识   。   shǐ使   yòng用   C   I   D   cān参   shù数   zhí值   “   0   ”   #   pèi配   zhì置   biāo标   tí题   zài在   tú图   biāo标   lán栏   。

Each heading has its own set of options with these names and values:

每个标题都有自己的一套选项，这些名称和值：

anchor	An anchor that specifies how the heading is                    aligned within the column; see Section 5.5, “Anchors”.  The default value is tk.W.
command	A procedure to be called when the user clicks on                    this column heading.
image	To present a graphic in the column heading (either                    with or instead of a text heading), set this                    option to an image, as specified in Section 5.9, “Images”.
text	The text that you want to appear in the column                    heading.

如果您提供没有关键字参数，该方法将返回一个显示列标题选项当前设置的字典。

rú如   guǒ果   nín您   tí提   gōng供   méi没   yǒu有   guān关   jiàn键   zì字   cān参   shù数   ，   gāi该   fāng方   fǎ法   jiāng将   fǎn返   huí回   yī一   gè个   xiǎn显   shì示   liè列   biāo标   tí题   xuǎn选   xiàng项   dāng当   qián前   shè设   zhì置   de的   zì字   diǎn典   。

• To interrogate the current value of some heading option X, use an argument of the form option=X; the method will return the current value of that option.

•审问一些标题选项当前x的值，使用表格选项= x参数；该方法将返回该选项的当前值。

•   shěn审   wèn问   yī一   xiē些   biāo标   tí题   xuǎn选   xiàng项   dāng当   qián前   x   de的   zhí值   ，   shǐ使   yòng用   biǎo表   gé格   xuǎn选   xiàng项   =   x   cān参   shù数   ；   gāi该   fāng方   fǎ法   jiāng将   fǎn返   huí回   gāi该   xuǎn选   xiàng项   de的   dāng当   qián前   zhí值   。

• You can set one or more heading options by supplying them as keyword arguments such as “anchor=tk.CENTER”.

•可以设置一个或多个标题的选项提供给他们作为关键字参数如“anchor=tk.CENTER”.

.identify_column(x)

给定一个X坐标，此方法返回一个字符串的形式# N标识包含x坐标列。

gěi给   dìng定   yī一   gè个   X   zuò坐   biāo标   ，   cǐ此   fāng方   fǎ法   fǎn返   huí回   yī一   gè个   zì字   fú符   chuàn串   de的   xíng形   shì式   #   N   biāo标   shí识   bāo包   hán含   x   zuò坐   biāo标   liè列   。

Assuming that the icon column is displayed, the value of n is 0 for the icon column; 1 for the second physical column; 2 for the third physical column; and so on. Recall that the physical column number may be different from the logical column number in cases where you have rearranged them using the displaycolumns argument to the Treeview constructor.

假设显示图标列，n的值为图标列的0；第二个物理列的2；第三个物理列的1；等等。记得，物理列数可能不同于逻辑列数的情况下，你将使用displaycolumns TreeView构造函数参数。

jiǎ假   shè设   xiǎn显   shì示   tú图   biāo标   liè列   ，   n   de的   zhí值   wèi为   tú图   biāo标   liè列   de的   0   ；   dì第   èr二   gè个   wù物   lǐ理   liè列   de的   2   ；   dì第   sān三   gè个   wù物   lǐ理   liè列   de的   1   ；   děng等   děng等   。   jì记   de得   ，   wù物   lǐ理   liè列   shǔ数   kě可   néng能   bù不   tóng同   yú于   luó逻   jí辑   liè列   shǔ数   de的   qíng情   kuàng况   xià下   ，   nǐ你   jiāng将   shǐ使   yòng用   d   i   s   p   l   a   y   c   o   l   u   m   n   s   T   r   e   e   V   i   e   w   gòu构   zào造   hán函   shù数   cān参   shù数   。

If the icon column is not displayed, the value of n is 1 for the first physical column, 2 for the second, and so on.

如果不显示图标列，则N的值为第一个物理列的2，第二个物理列的1，等等。

.identify_element(x, y)

返回相对于小部件的位置（X，Y）的元素的名称，或“如果没有出现在该位置上的元素”。元素名称在50节中讨论，“TTK元层”。

.identify_region(x,           y))

由于给定一个点相对于小部件的坐标，该方法返回一个字符串，该字符串表示该控件的一部分包含了该点的内容。返回值可能包括：

'nothing'	The point is not within a functional part of the                    widget.
'heading'	The point is within one of the column headings.
'separator'	The point is located within the column headings                    row, but on the separator between columns.  Use                    the .identify_column() method to                    determine which column is located just to the                    left of this separator.
'tree'	The point is located within the icon column.
'cell'	The point is located within an item row but not                    within the icon column.

.identify_row(y)

如果坐标内的项目之一，此方法返回该项的IID。如果该垂直坐标不在项目中，该方法将返回一个空字符串。

.index(iid)

此方法返回的项的索引与指定其母相对独立，从零。

.set_children(item,          *newChildren)

用这种方法来改变其IID是项项目子项的设置。新建的参数是一个字符串序列IID。任何当前儿童项目不新建删除。

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

该方法将新项添加到树中，并返回该项的ID值。争论：

parent	To insert a new top-level item, make this argument                    an empty string.  To insert a new item as a child                    of an existing item, make this argument the parent                    item's iid.
index	This argument specifies the position among this                    parent's children where you want the new item to                    be added.  For example, to insert the item as                    the new first child, use a value of zero; to                    insert it after the parent's first child, use a                    value of 1; and so on.  To add the new item as                    the last child of the parent, make this argument's                    value 'end'.
iid	You may supply an iid for the item as a string                    value.  If you don't supply an iid, one will be                    generated automatically and returned by the                    method.

您也可以为该方法指定多个项目选项作为关键字参数。

image	You may display an image just to the right of the                    icon for this item's row by providing an image=I                    argument, where I is an image as specified                    in Section 5.9, “Images”.
open	This option specifies whether this item will be                    open initially.  If you supply open=False, this item will be closed.  If                    you supply open=True, the item's                    children will be visible whenever the item itself                    is visible.  The default value is False.
tags	You may supply one or more tag strings to be                    associated with this item.  The value may be                    either a single string or a sequence of strings.
text	You may supply text to be displayed within the                    icon column of this item.  If given, this text                    will appear just to the right of the icon, and                    also to the right of the image if provided.
values	This argument supplies the data items to be                    displayed in each column of the item.  The values                    are supplied in logical column order.  If too few                    values are supplied, the remaining columns will be                    blank in this item; if too many values are                    supplied, the extras will be discarded.

.item(iid[, option[, **kw]])

用这种方法来设置或检索选项指定IID项目内。参阅。insert()方法为项目选择的名字。

yòng用   zhè这   zhǒng种   fāng方   fǎ法   lái来   shè设   zhì置   huò或   jiǎn检   suǒ索   xuǎn选   xiàng项   zhǐ指   dìng定   I   I   D   xiàng项   mù目   nèi内   。   cān参   yuè阅   。   i   n   s   e   r   t   (   )   fāng方   fǎ法   wèi为   xiàng项   mù目   xuǎn选   zé择   de的   míng名   zi字   。

With no arguments, it returns a dictionary whose keys are the option names and the corresponding values are the settings of those options. To retrieve the value of a given option, pass the option's name as its second argument. To set one or more options, pass them as keyword arguments to the method.

没有参数，它返回一个字典，它的键是选项名称，相应的值是这些选项的设置。要检索一个给定选项的值，将该选项的名称传递给它的第二个参数。要设置一个或多个选项，将它们作为关键字参数传递给方法。

.move(iid, parent, index)

将指定的值由IID位置索引父所指定的项目项下。家长和指标参数相同的参数的方法。index()。

.next(iid)

如果指定IID的项目不是其父亲的最后一个孩子，这个方法返回以下孩子的IID；如果是其父亲的最后一个孩子，这个方法将返回一个空字符串。如果指定的项目是一个顶级项目，方法返回下一个顶级项目的IID，或空字符串，如果指定的项目是最后的顶级项目。

.parent(iid)

如果指定IID的项目是一个顶级项目，此方法将返回一个空字符串；否则返回的IID，项母。

.prev(iid)

如果指定IID的项目并不是其父母的第一个孩子，这个方法返回之前的孩子的IID；否则返回一个空字符串。如果指定的项目是一个顶级项目，此方法返回之前的顶级项目的IID，或空字符串，如果是第一个顶级项目。

.see(iid)

这种方法确保指定的IID项目是可见的。关闭的任何一的祖先都是开放的。Widget是滚动，如果有必要，使项目出现。

.selection_add(items)

除了已选择的任何项目外，还添加了指定的项目。参数可以是一个单一的IID或一个序列的系统。

.selection_remove(items)

取消任何项目的指定参数，这可能是一个单一的IID或一个序列的系统。

.selection_set(items)

只有指定的项将被选中；如果其他项目进行之前，他们会选择。

.selection_toggle(items)

参数可以是一个单一的IID或一个序列的系统。每个项目指定的参数，如果它被选中，取消它；如果它被选中，选择它。

.set(iid, column=None,          value=None)

使用此方法检索或设置列值的项指定IID。用一个参数，方法返回一个字典：键是列标识符，而每个相关的值都是在相应的列中的文本。

shǐ使   yòng用   cǐ此   fāng方   fǎ法   jiǎn检   suǒ索   huò或   shè设   zhì置   liè列   zhí值   de的   xiàng项   zhǐ指   dìng定   I   I   D   。   yòng用   yī一   gè个   cān参   shù数   ，   fāng方   fǎ法   fǎn返   huí回   yī一   gè个   zì字   diǎn典   ：   jiàn键   shì是   liè列   biāo标   shí识   fú符   ，   ér而   měi每   gè个   xiāng相   guān关   de的   zhí值   dōu都   shì是   zài在   xiāng相   yìng应   de的   liè列   zhōng中   de的   wén文   běn本   。

With two arguments, the method returns the data value from the column of the selected item whose column identifier is the column argument. With three arguments, the item's value for the specified column is set to the third argument.

有两个参数，方法将从所选项目的列返回数据值，其列标识符为列参数。有了三个参数，指定的列的值将被设置为第三个参数。

.tag_bind(tagName,          sequence=None, callback=None)

该方法将由回调参数所设定的标签标签名指定事件处理程序。序列和回调参数相同的序列和功能参数。（）方法在26节中描述的，“通用部件的方法”。

.tag_configure(tagName,          option=None, **kw)

这种方法可以询问或设置影响所有的物品都有标签，标签名的外观选项。标签选项包括：

'background'	The background color.
'font'	The text font.
'foreground'	The foreground color.
'image'	An image to be                    displayed in items with the given tag.

当调用一个参数时，它返回当前标记选项的字典。要返回一个特定选项x的值，使用X作为第二个参数。

dāng当   diào调   yòng用   yī一   gè个   cān参   shù数   shí时   ，   tā它   fǎn返   huí回   dāng当   qián前   biāo标   jì记   xuǎn选   xiàng项   de的   zì字   diǎn典   。   yào要   fǎn返   huí回   yī一   gè个   tè特   dìng定   xuǎn选   xiàng项   x   de的   zhí值   ，   shǐ使   yòng用   X   zuò作   wéi为   dì第   èr二   gè个   cān参   shù数   。

To set one or more options, use keyword arguments such as foreground='red'.

设置一个或多个选项，使用关键字参数例如前景='red'

.tag_has(tagName[,           iid])

用一个参数调用，该方法返回一个带有标签的标签名的所有项目的IID值列表。如果你提供一个IID作为第二个参数，该方法返回true，如果有标签的标签名，IID的项目，否则为假。

.xview(*args)

这是用于连接水平滚动条滚动部件的常用方法。有关详细信息，请参见第22.1节，“滚动条命令回调”。

.yview(*args)

这是用于连接垂直滚动条滚动部件的常用方法。有关详细信息，请参见第22.1节，“滚动条命令回调”。