【Tkinter系列05/15】小部件（框架标签和列表）

续接上文：【Tkinter系列04/15】界面小部件（选择钮、行编辑器）

11. 小部件`Frame`

框架基本上只是其他小部件的容器。

应用程序的根窗口基本上是一个框架。
每个框架都有自己的网格布局，因此每个框架中小部件的网格化框架独立工作。
框架小部件是使您的应用模块化。您可以对一组相关的通过将小部件放入复合小部件中，将它们放入框架。更好的是，您可以声明一个新类继承自，添加自己的接口。这是隐藏一组相关交互的详细信息来自外界的小部件。Frame

在根窗口或框架中创建新的框架构件叫：parent

   w = Frame(parent, option, ...)

构造函数返回新小部件。选项：Frame

表 19.框架构件选项

`bg`或`background`	框架的背景色。请参见第 5.3 节 “颜色”。
`bd`或`borderwidth`	框架边框的宽度。默认值为 0（否）边框）。有关允许的值，请参见第 5.1 节 “尺寸”。
`cursor`	鼠标在框架内时使用的光标控件;请参见第 5.8 节 “游标”。
`height`	新垂直尺寸框架。除非您也调用框架，否则这将被忽略;请参见第 4.2 节 “其他网格管理方法”。`.grid_propagate(0)`
`highlightbackground`	焦点的颜色当帧没有焦点时加亮显示。请参见第 53 节 “焦点：路由键盘输入”。
`highlightcolor`	颜色显示在焦点加亮当帧具有焦点时。
`highlightthickness`	焦点突出显示的厚度。
`padx`	通常，A 紧贴围绕其内容。添加水平像素框架内的空间，设置 .`FrameNpadx=N`
`pady`	用于在框架内添加垂直空间。见上文。`padx`
`relief`	帧的默认浮雕是，这意味着帧将与其混合环境。要在框架周围放置边框，请设置其为正值并将其浮雕设置为标准浮雕之一类型;请参见第 5.6 节 “浮雕样式”。`tk.FLATborderwidth`
`takefocus`	通常，输入不会访问框架小部件焦点（有关概述，请参见第 53 节 “焦点：路由键盘输入” 的本主题）。但是，您可以设置是否希望框架接收键盘输入。要处理此类输入，您需要需要为键盘事件创建绑定; 有关事件的更多信息，请参见第 54 节 “事件”和绑定。`takefocus=1`
`width`	新框架的水平尺寸。请参见第 5.1 节 “尺寸”。此值为忽略，除非您也调用框架;请参见第 4.2 节 “其他网格管理方法”。`.grid_propagate(0)`

12. 小部件`Label`

标签微件可以在相同的样式，或者位图或图像。创建标注微件在根窗口或框架中：parent

    w = tk.Label(parent, option, ...)

构造函数返回新小部件。选项包括：Label

表 20.标签微件选项

`activebackground`	背景颜色为当鼠标悬停在小部件上时显示。
`activeforeground`	前景色为当鼠标悬停在小部件上时显示。
`anchor`	此选项控制文本的位置如果小部件的空间大于文本需要的空间。缺省值为，这使文本在可用空间中居中。对于其他值，请参见第 5.5 节 “锚点”。为例如，如果使用，文本将位于左上角可用空间的一角。`anchor=tk.CENTERanchor=tk.NW`
`bg`或`background`	标签区域的背景色。请参见第 5.3 节 “颜色”。
`bitmap`	将此选项设置为等于位图或图像对象标签将显示该图形。请参见第 5.7 节 “位图”和第 5.9 节 “图像”。
`bd`或`borderwidth`	标签周围边框的宽度;请参见第 5.1 节 “尺寸”。默认值为 <> 像素。
`compound`	如果你想要这个小部件同时显示文本和图形（位图）或图像），选项指定图形的相对方向相对于文本。值可以是、、或中的任何一个。例如，如果指定，则图形将是显示在文本下方。`Labelcompoundtk.LEFTtk.RIGHTtk.CENTERtk.BOTTOMtk.TOPcompound=BOTTOM`
`cursor`	鼠标悬停在此位置上时出现的光标标签。请参见第 5.8 节 “游标”。
`disabledforeground`	当小部件为时要显示的前景色。`statetk.DISABLED`
`font`	如果要在此标签中显示文本（使用 or 选项，该选项指定该文本将显示什么字体。请参见第 5.4 节 “键入字体”。`texttextvariablefont`
`fg`或`foreground`	如果要在此显示文本或位图标签，此选项指定文本的颜色。如果要显示位图，则颜色如下这将出现在 1 位的位置位图。请参见第 5.3 节 “颜色”。
`height`	标签的高度（以行为单位）（不是像素！如果未设置此选项，则标签的大小将适合其内容。
`highlightbackground`	焦点的颜色当小组件没有焦点时突出显示。
`highlightcolor`	颜色当小组件具有焦点时，焦点突出显示。
`highlightthickness`	焦点突出显示的厚度。
`image`	要在标签微件中显示静态图像，请将图像对象的此选项。请参见第 5.9 节 “图像”。
`justify`	指定文本的多行方式彼此对齐：左对齐、居中对齐（默认值）或右对齐。`tk.LEFTtk.CENTERtk.RIGHT`
`padx`	在文本的左侧和右侧添加了额外的空格在小部件中。默认值为 1。
`pady`	在文本的上方和下方添加了额外的空格小部件。默认值为 1。
`relief`	指定装饰性边框的外观标签周围。默认值为 ;有关其他值，请参见第 5.6 节 “浮雕样式”。`tk.FLAT`
`state`	默认情况下，小部件位于状态。设置此选项以使其无响应到鼠标事件。状态将为鼠标悬停在小部件上的时间。`Entrytk.NORMALtk.DISABLEDtk.ACTIVE`
`takefocus`	通常，焦点不会在小部件之间循环;请参见第 53 节 “焦点：路由键盘输入”。如果您希望此小部件由焦点访问，设置.`Labeltakefocus=1`
`text`	在标签中显示一行或多行文本小组件，将此选项设置为包含发短信。内部换行符（）将强制换行。`'\n'`
`textvariable`	将标签构件中显示的文本从属到类的控制变量，将此选项设置为该变量。请参见第 52 节 “控制变量：小部件背后的值”。`StringVar`
`underline`	您可以显示下划线（）在第 `n`个字母下方文本，从 0 开始计数，通过设置此选项到 `n`。默认值为，表示否强调。`_underline=-1`
`width`	标签的宽度（以字符为单位）（不是像素！如果未设置此选项，标签的大小将调整为适合其内容。
`wraplength`	您可以限制每行中的字符数通过将此选项设置为所需的数字。这默认值 0 表示线条将被断开仅在换行符处。

13. 小部件`LabelFrame`

该小部件与“框架”小部件一样，是一个空间容器 - 可以包含其他小部件。但是，与小部件不同，小部件允许您将标签显示为周围边框的一部分该地区。LabelFrameFrameLabelFrame

下面是一个小部件的示例包含两个小部件。请注意，标签“重要控件”中断了边境。此小部件说明了默认的浮雕（请参见第 5.6 节 “浮雕样式”）和默认标签锚点，其将标签放置在顶部的左侧框架。LabelFrameButtonGROOVE'nw'

在根窗口或框架：LabelFrameparent

    w = tk.LabelFrame(parent, option, ...)

此构造函数返回新小部件。选项：LabelFrame

表 21.标签框架构件选项

`bg`或`background`	要在内部显示的背景色控件;请参见第 5.3 节 “颜色”。
`bd`或`borderwidth`	围绕的周长绘制的边框宽度小部件;请参见第 5.1 节 “尺寸”。这默认值为两个像素。
`cursor`	选择鼠标在小部件上;请参见第 5.8 节 “游标”。
`fg`或`foreground`	要使用的颜色作为标签文本。
`height`	新框架的垂直尺寸。这将是忽略，除非您也调用框架;请参见第 4.2 节 “其他网格管理方法”。`.grid_propagate(0)`
`highlightbackground`	焦点的颜色当小组件没有焦点时突出显示。
`highlightcolor`	颜色当小组件具有焦点时，焦点突出显示。
`highlightthickness`	焦点突出显示的厚度。
`labelanchor`	使用此选项可指定小组件边框上的标注。默认位置为，它放置上边框左端的标签。对于九个可能的标签位置，参考这个图：`'nw'`
`labelwidget`	您可以使用任何小部件代替文本标签通过传递该小部件作为值来传递标签此选项。如果同时提供和选项，则会忽略该选项。`labelwidgettexttext`
`padx`	使用此选项可在内部添加其他填充微件框架的左侧和右侧。该值以像素为单位。
`pady`	使用此选项可在内部添加其他填充小部件框架的顶部和底部。这值以像素为单位。
`relief`	此选项控制边框的外观在小部件的外部周围。默认风格是 ;对于其他值，请参见第 5.6 节 “浮雕样式”。`tk.GROOVE`
`takefocus`	通常，小部件不会获得焦点;供应要使此选项的值焦点遍历序列的小组件部分。有关更多信息，请参见第 53 节 “焦点：路由键盘输入”。`True`
`text`	标签的文本。
`width`	新框架的水平尺寸。这将是忽略，除非您也调用框架;请参见第 4.2 节 “其他网格管理方法”。`.grid_propagate(0)`

标签小部件没有特殊方法，除了常见的（参见第 26 节 “通用小部件方法”）。

14. 小部件`Listbox`

（14. 列表框小部件 (anzeljg.github.io)）

列表框小部件的用途是显示一组文本行。通常，它们旨在允许用户从列表中选择一个或多个项目。所有文本行使用相同的字体。如果你需要什么更像是一个文本编辑器，请参见第 24 节 “文本小部件”。

在根窗口中创建新的列表框小组件，或框架：parent

    w = tk.Listbox(parent, option, ...)

此构造函数返回新小部件。选项：Listbox

表 22.列表框小组件选项

`activestyle`	此选项指定活动线。它可能具有以下任何值： `'underline'` 活动线带有下划线。这是默认选项。 `'dotbox'` 活动线括在虚线中四面线。 `'none'` 活动线没有特殊外观。
`bg`或`background`	列表框中的背景色。
`bd`或`borderwidth`	列表框周围的边框宽度。默认值为 5 像素。有关可能的值，请参见第 1.<> 节 “维度”。
`cursor`	鼠标悬停在列表框。请参见第 5.8 节 “游标”。
`disabledforeground`	文本的颜色在列表框中，当其为 .`statetk.DISABLED`
`exportselection`	默认情况下，用户可以选择带有鼠标，所选文本将导出到剪贴板。要禁用此行为，请使用。`exportselection=0`
`font`	用于列表框中文本的字体。请参见第 5.4 节 “键入字体”。
`fg`或`foreground`	用于列表框中文本的颜色。请参见第 5.3 节 “颜色”。
`height`	行数（不是像素！显示在列表框中。默认值为 10。
`highlightbackground`	当小部件执行时，焦点的颜色会突出显示没有焦点。请参见第 53 节 “焦点：路由键盘输入”。
`highlightcolor`	小部件时焦点突出显示中显示的颜色有重点。
`highlightthickness`	焦点突出显示的厚度。
`listvariable`	连接到的 A 列表框中值的完整列表（请参见第 52 节 “控制变量：小部件后面的值”。`StringVar` 如果调用的方法的，你会得到返回窗体的字符串，其中每个字符串都是列表框的一行的内容。`.get()listvariable"('v0', 'v1', ...)"vi` 更改列表框中的整行集立即调用，其中是包含行值之间有空格。`.set(s)listvariables` 例如，如果是与列表框的选项关联的，则此调用将列表框设置为包含三行：`listConStringVarlistvariable` `listCon.set('ant bee cicada')` 此调用将返回字符串：`"('ant', 'bee', 'cicada')"` `listCon.get()`
`relief`	选择三维边框底纹效果。缺省值为。对于其他值，请参见第 5.6 节 “浮雕样式”。`tk.SUNKEN`
`selectbackground`	用于显示所选文本的背景色。
`selectborderwidth`	要在选定边框周围使用的边框宽度发短信。默认值为所选项目为以纯色块显示;如果增加，则条目为移得更远，所选条目将显示浮雕（请参见第 5.6 节 “浮雕样式”）。`selectbackgroundselectborderwidthtk.RAISED`
`selectforeground`	用于显示所选文本的前景色。
`selectmode`	确定可以选择多少项以及如何选择鼠标拖动会影响选择： `tk.BROWSE`：通常，您只能从列表框中选择一行。如果你单击某个项目，然后拖动到其他项目行，选择将遵循鼠。这是默认值。 `tk.SINGLE`：您只能选择一行，你不能拖动鼠标 - 单击按钮 1 的任意位置，该行处于选中状态。 `tk.MULTIPLE`：您可以选择任何一次行数。点击任何切换是否选择线条。 `tk.EXTENDED`：您可以选择任何通过单击在第一行并拖动到最后一行线。
`state`	默认情况下，列表框处于该状态。使列表框对鼠标无响应事件中，将此选项设置为。`tk.NORMALtk.DISABLED`
`takefocus`	通常，焦点将通过列表框跳动部件。将此选项设置为 0 以获取微件不在序列中。请参见第 53 节 “焦点：路由键盘输入”。
`width`	小部件的宽度（以字符为单位）（不是像素！这宽度基于平均字符，因此一些按比例字体表示的此长度的字符串可以不合适。默认值为 20。
`xscrollcommand`	如果要允许用户滚动列表框水平方向，可以将列表框小部件链接到水平滚动条。将此选项设置为滚动条的方法。请参见第 14.1 节 “滚动列表框小部件”以获取更多信息可滚动的列表框小组件。`.set`
`yscrollcommand`	如果要允许用户滚动列表框垂直方向，可以将列表框小部件链接到垂直滚动条。将此选项设置为滚动条的方法。请参见第 14.1 节 “滚动列表框小部件”。`.set`

一组特殊的索引表单用于许多列表框对象上的方法：

如果将索引指定为整数，则它引用列表框中具有该索引的行，从 0 开始计数。
索引是指列表框。tk.END
索引是指选定的线。如果列表框允许多项选择，则指上次选择的行。tk.ACTIVE
表单的索引字符串引用最接近的行坐标（，）相对到小部件的左上角。'@x,y'xy

对象上的方法包括：Listbox

.activate(index)

选择由给定指定的行。index

.bbox(index)

返回由 as 指定的行的边界框一个 4 元组，其中左上角框的像素位于和和是以像素为单位。返回的值仅包括文本占用的行的一部分。index(xoffset, yoffset, width, height)(xoffset, yoffset)widthheightwidth

如果参数指定的行不是可见，此方法返回 .如果它部分可见，返回的边界框可能延伸到可见区域之外。indexNone

.curselection()

返回一个元组，其中包含选定的一个或多个元素，从 0 开始计数。如果未选择任何内容，返回一个空元组。

.delete(first, last=None)

删除其索引在范围内的行 [， ]，包含（与通常的 Python 习语相反，其中删除在最后一个索引附近停止），从 0 开始计数。如果省略第二个参数，单行索引将被删除。firstlastfirst

.get(first, last=None)

返回一个元组，其中包含以下行的文本索引从到，包括。如果省略第二个参数，则返回文本最接近的行。firstlastfirst

.index(i)

如果可能，定位列表框，以便包含索引的行位于顶部的小部件。i

.insert(index, *elements)

在列表框中插入一个或多个新行之前由指定的行。如果要添加，请使用第一个参数列表框末尾的新行。indextk.END

.itemcget(index, option)

检索特定选项值之一列表框中的行。有关选项值，请参见下文。如果给定的选项有未为给定行设置，返回值将是一个空字符串。itemconfig

.itemconfig(index, option=value, ...)

更改指定行的配置选项由。选项名称包括：index

background

给定行的背景色。

foreground

的文本颜色给定的行。

selectbackground

给定行的背景色当它被选中时。

selectforeground

给定行的文本颜色当它被选中时。

.nearest(y)

返回最接近 y 坐标 y 相对于列表框小组件。

.scan_dragto(x, y)

见下文。scan_mark

.scan_mark(x, y)

使用此方法实现快速扫描稳定滚动 - 列表框。要得到这个功能，将某些鼠标按钮事件绑定到处理程序与电流一起调用鼠标位置。然后将事件绑定到使用当前鼠标调用的处理程序位置，列表框将以一定速率滚动与位置之间的距离成正比记录者和电流位置。scan_mark<Motion>scan_dragtoscan_mark

.see(index)

调整列表框的位置，使行引用是可见的。index

.selection_anchor(index)

将“选择锚点”放在参数选择的行。一旦这个锚点已经放置，你可以用特殊索引形式 .indextk.ANCHOR

例如，对于名为的列表框，此序列将选择第 3、4 和 5 行：lbox

    lbox.selection_anchor(3)
    lbox.selection_set(tk.ANCHOR,5)

.selection_clear(first, last=None)

取消选择索引和（包括）之间的所有线条。如果省略第二个参数，则取消选择该行带索引 .firstlastfirst

.selection_includes(index)

如果给定的行是选中后，则返回 1。index

.selection_set(first, last=None)

选择索引和（包括）之间的所有线条。如果省略第二个参数，则选择该行带索引 .firstlastfirst

.size()

返回列表框中的行数。

.xview()

若要使列表框水平滚动，请设置关联的此方法的水平滚动条。请参见第 14.1 节 “滚动列表框小部件”。command

.xview_moveto(fraction)

滚动列表框，使最左侧的其最长线的宽度在左侧之外列表框。分数在 [0，1] 范围内。fraction

.xview_scroll(number, what)

水平滚动列表框。对于论点，使用任一方式滚动字符，或滚动页，即按列表框的宽度。参数告诉要滚动多少;负值在列表框中将文本向右移动，正值向左。whattk.UNITStk.PAGESnumber

.yview()

若要使列表框可垂直滚动，请将关联的垂直滚动条的选项设置为方法。请参见第 14.1 节 “滚动列表框小部件”。command

.yview_moveto(fraction)

滚动列表框，使其最长线的宽度在左侧之外列表框。分数在 [0，1] 范围内。fraction

.yview_scroll(number, what)

垂直滚动列表框。对于论点，使用任一按行滚动，或按页面滚动，即按列表框的高度。论点告诉要滚动多少;负值移动列表框中的文本向下，以及正值向上移动文本。whattk.UNITStk.PAGESnumber

14.1. 滚动小部件`Listbox`

这是一个代码片段，说明了创建和将列表框链接到水平和垂直滚动条。

   self.yScroll = tk.Scrollbar(self, orient=tk.VERTICAL)
    self.yScroll.grid(row=0, column=1, sticky=tk.N+tk.S)

    self.xScroll = tk.Scrollbar(self, orient=tk.HORIZONTAL)
    self.xScroll.grid(row=1, column=0, sticky=tk.E+tk.W)

    self.listbox = tk.Listbox(self,
         xscrollcommand=self.xScroll.set,
         yscrollcommand=self.yScroll.set)
    self.listbox.grid(row=0, column=0, sticky=tk.N+tk.S+tk.E+tk.W)
    self.xScroll['command'] = self.listbox.xview
    self.yScroll['command'] = self.listbox.yview