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

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

selectmode

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

show

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

style