如何使用本节

本节设计分为两部分：前半部分（大致）覆盖背景材料，而后半部分可以作为方便参考键盘.

当试图回答“我该怎么做”这个形式的问题时，通常最好找出如何在直接Tk中做“blah”，然后将其转换回相应的tkinter来电。Python程序员通常可以通过查看Tk文档来猜测正确的Python命令。这意味着为了使用Tkinter，你必须对Tk有所了解。此文档无法履行该角色，因此我们所能做的最好的事情就是指向存在的最佳文档。以下是一些提示：

• 作者强烈建议获取Tk手册页的副本。具体来说，manN目录中的手册页最有用.man3 man页面描述了Tk库的C接口，因此对脚本编写者没有特别的帮助.
• Addison-Wesley出版了一本名为Tcl的书和由JohnOusterhout撰写的Tk Toolkit（ISBN 0-201-63337-X），对新手Tcl和Tk的一个很好的介绍。这本书并非详尽无遗，而且对于许多细节来说，这本书都是按照人们的要求推出的.
• tkinter/__init__.py对大多数人来说是最后的手段，但是当没有别的意义时，它可以成为一个好去处.

一个简单的Hello World程序

import tkinter as tkclass Application(tk.Frame):    def __init__(self, master=None):        super().__init__(master)        self.master = master        self.pack()        self.create_widgets()    def create_widgets(self):        self.hi_there = tk.Button(self)        self.hi_there["text"] = "Hello World\n(click me)"        self.hi_there["command"] = self.say_hi        self.hi_there.pack(side="top")        self.quit = tk.Button(self, text="QUIT", fg="red",                              command=self.master.destroy)        self.quit.pack(side="bottom")    def say_hi(self):        print("hi there, everyone!")root = tk.Tk()app = Application(master=root)app.mainloop()

设置选项

选项控制窗口小部件的颜色和边框宽度。选项可以用三种方式设置：

在对象创建时，使用关键字参数

fred = Button(self, fg="red", bg="blue")

创建对象后，将选项名称视为字典索引

fred["fg"] = "red"fred["bg"] = "blue"

使用config（）在对象创建之后更新多个attrs的方法

fred.config(fg="red", bg="blue")

有关给定选项及其行为的完整说明，请参阅相关小部件的Tk联机帮助页.

注意手册页列表“每个小部件的标准选项“和”WIDGET SPECIFIC OPTIONS“。前者是许多小部件共有的选项列表，后者是与特定小部件特有的选项。标准选项记录在options(3)手册页上

在本文档中没有区分标准和小部件特定选项。某些选项不适用于某些类型的小部件。givenwidget是否响应特定选项取决于窗口小部件的类;按钮具有command选项，标签没有.

给定窗口小部件支持的选项列在该窗口小部件的手册页中，或者可以在运行时通过调用config()方法无需查询或通过调用keys()该小部件上的方法。这些调用的返回值是一个字典，其键是astring的选项名称（例如，"relief"），其值为5-tuples。

有些选项，比如bg是具有长名称的常见选项的同义词（bg是“背景”的简写）。通过config()方法，速记选项的名称将返回2元组，而不是5元组。2元组的回传将包含同义词的名称和“真实”选项（例如("bg", "background")).

示例：

>>> print(fred.config()){"relief": ("relief", "relief", "Relief", "raised", "groove")}

当然，打印的字典将包括所有可用选项和它们的值。这仅仅是作为一个例子.

包装工

封隔器是Tk的几何管理机制之一。几何管理器用于指定小部件在其容器内的定位的相对位置 – 它们的相互关系master。与更麻烦的placer（这种情况不常用，我们在这里没有涉及）相比，包装商采用了定性关系规范 – above, to the left of,filling等等 – 并且一切都用来确定你的确切位置坐标.

任何尺寸masterwidget取决于里面“slave widgets”的大小。打包器用于控制从属小部件在其所包含的主控内部出现的位置。您可以将小部件打包到框架中，并将框架打包到其他框架中，以实现您想要的布局。此外，这种布置是动态调整的，以适应配置的一次性更改，一旦打包就可以了.

注意到小部件在使用几何管理器指定其几何图形之前不会显示。遗漏几何规格是一个常见的早期错误，然后在创建窗口小部件但没有出现时会感到惊讶。一个小部件只有在它应用了封隔器的pack()方法之后才会出现.

可以使用关键字选项/值对调用pack（）方法来控制其中窗口小部件将显示在其容器中，以及在调整主应用程序窗口大小时的行为方式。以下是一些例子：

fred.pack()                     # defaults to side = "top"fred.pack(side="left")fred.pack(expand=1)

Packer Options

有关打包器的更多信息及其可以选择的选项，请参阅John Ousterhout的书的手册页和第183页.

anchor

锚型。表示包装工将每个奴隶放在其包裹中的地方.

扩大

布尔，0要么 1.

填

法律价值："x", "y", "both", "none".

ipadx和ipady

距离 – 指定从属小部件两侧的内部填充.

padx和pady

距离 – 指定从属小部件两侧的外部填充.

side

合法值是："left", "right", "top", "bottom".

耦合小部件变量

某些小部件（如文本条目小部件）的当前值设置可以通过使用特殊选项直接连接到应用程序变量。这些选项是variable, textvariable, onvalue, offvalue和value。这种连接有两种方式：如果变量因任何原因而改变，它所连接的小部件将被更新以反映新值.

不幸的是，在tkinter通过variable或textvariable选项。唯一可行的变量是变量，这些变量是从一个名为Variable的类中继承的，在tkinter.

已经定义了许多有用的Variable子类：StringVar, IntVar, DoubleVar，和BooleanVar。要读取这个变量的当前值，请在其上调用get()方法，并更改其值，调用set()方法。如果您遵循此协议，小部件将始终跟踪变量的值，而不需要进一步干预.

例如：

class App(Frame):    def __init__(self, master=None):        super().__init__(master)        self.pack()        self.entrythingy = Entry()        self.entrythingy.pack()        # here is the application variable        self.contents = StringVar()        # set it to some value        self.contents.set("this is a variable")        # tell the entry widget to watch this variable        self.entrythingy["textvariable"] = self.contents        # and here we get a callback when the user hits return.        # we will have the program print out the value of the        # application variable when the user hits return        self.entrythingy.bind("<Key-Return>",                              self.print_contents)    def print_contents(self, event):        print("hi. contents of entry is now ---->",              self.contents.get())

窗口管理器

在Tk中，有一个实用命令wm，用于与windowmanager进行交互。wm命令的选项允许您控制标题，位置，图标位图等内容。在tkinter，这些命令已经作为Wm类的方法实现。Toplevel小部件来自Wm类，所以可以直接调用Wm方法

要获得包含给定窗口小部件的顶层窗口，您通常只需要指向窗口小部件的主窗口。当然，如果小部件已经打包在框架内，则主控制器将不代表顶层窗口。要获取包含任意窗口小部件的toplevel窗口，可以调用_root()方法。此方法以下划线开头，表示此函数是实现的一部分，而不是Tk功能的接口.

以下是典型用法的一些例子：

import tkinter as tkclass App(tk.Frame):    def __init__(self, master=None):        super().__init__(master)        self.pack()# create the applicationmyapp = App()## here are method calls to the window manager class#myapp.master.title("My Do-Nothing Application")myapp.master.maxsize(1000, 400)# start the programmyapp.mainloop()

Tk选项数据类型

锚

合法值是指南针的点："n", "ne", "e", "se","s", "sw", "w", "nw"，还有"center".

位图

有八个内置的命名位图："error", "gray25","gray50", "hourglass", "info", "questhead", "question","warning"。要指定X位图文件名，请给出文件的完整路径，前面加上@，如"@/usr/contrib/bitmap/gumby.bit".

boolean

您可以传递整数0或1或字符串"yes"或"no".

回调

这是任何不带参数的Python函数。例如：

def print_it():    print("hi there")fred["command"] = print_it

颜色

颜色可以作为rgb.txt文件中X颜色的名称给出，或者作为以4位表示RGB值的字符串："#RGB",8位："#RRGGBB",12位“"#RRRGGGBBB"，或16位"#RRRRGGGGBBBB"范围，其中R，G，B在此表示任何合法的十六进制数字。有关详细信息，请参阅Ousterhout的书的第160页.

cursor

可以使用cursorfont.h的标准X光标名称，不带XC_前缀。例如，要获得一个手形光标（XC_hand2），请使用字符串"hand2"。你也可以指定你自己的位图和掩码文件。参见Ousterhout的书的第179页.

distance

屏幕距离可以用像素或绝对距离来指定。像素以数字的形式给出绝对距离为字符串，尾随字符表示单位：c表示厘米，i表示英寸，m formillimetres，p表示打印机的点数。例如，3.5英寸表示为"3.5i".

字体

Tk使用列表字体名称格式，例如{courier 10 bold}。带有正数的字体大小以点为单位;带负数的大小以像素为单位测量.

geometry

这是一个形式为widthxheight的字符串，其中大多数小部件的宽度和高度都以像素为单位（小部件的字符数）显示文字）。例如：fred["geometry"] = "200x100".

对齐

合法值是字符串："left", "center", "right"，和"fill".

区域

这是一个带有四个以空格分隔的元素的字符串，每个元素都是合法距离（见上文）。例如："2 3 4 5"和"3i 2i 4.5i 2i"和"3c 2c 4c 10.43c"都是合法的区域.

relief

确定小部件的边框样式是。合法值是："raised", "sunken", "flat", "groove"和"ridge".

scrollcommand

这几乎总是某些滚动条小部件的set()方法，但可以是任何一个小部件方法单个参数.

wrap：

必须是以下之一："none", "char"，或"word".

绑定和事件

widget命令中的bind方法允许您监视某些事件，并在发生该事件类型时触发回调函数。bind方法的形式是：

def bind(self, sequence, func, add=""):

where：

sequence

是一个字符串，表示目标类型的事件。（有关详细信息，请参阅绑定手册页和John Ousterhout的书的第201页）.

func

是一个Python函数，带有一个参数，在事件发生时被调用。一个事件实例将作为参数传递。（以这种方式部署的功能通常称为callbacks.)

add

可选，""或"+"。传递空字符串表示此绑定将替换与此事件关联的任何其他绑定。传递"+"意味着将此函数添加到绑定到此事件类型的函数列表中.

例如：

def turn_red(self, event):    event.widget["activeforeground"] = "red"self.button.bind("<Enter>", self.turn_red)

注意事件的widget字段是如何在turn_red()打回来。该字段包含捕获Xevent的小部件。下表列出了您可以访问的其他事件字段，以及它们如何在Tk中表示，这在引用Tk手册页时很有用.

索引参数

许多小部件需要传递“index”参数。它们在Text小部件中的特定位置使用topoint，或者在anEtry小部件中使用特定字符，或者在Menu小部件中使用特定菜单项.

Entry小部件索引（索引，视图索引等）

条目小部件具有引用正在显示的文本中的字符位置的选项。您可以使用这些tkinter函数来访问文本小部件中的这些特殊点：

文本小部件索引

文本小部件的索引表示法非常丰富，最好在Tkman中描述pages.

Menu indexes（menu.invoke（），menu.entryconfig（）等）

菜单的一些选项和方法操作特定的菜单项。无论何时选项或参数都需要amenu索引，您可以传入：

• 一个整数，它引用窗口小部件中条目的数字位置，从顶部开始计数，从0开始;
• 字符串"active"，表示当前光标下的菜单位置;
• 字符串"last"表示最后一个菜单项;
• 一个以@开头的整数，如@6，其中整数被解释为菜单坐标系中的一个像素坐标;
• 字符串"none"，表示根本没有菜单条目，最常用于menu.activate（）以停用所有条目，最后，
• 与菜单条目的标签模式匹配的文本字符串，从顶部进行扫描菜单到底部。请注意，这个索引类型在所有其他类型之后被考虑，这意味着标签last, active或none的菜单项的匹配可能被解释为aboveliterals，而不是

Images

对于XMM格式的图像，可以通过tkinter.Image：

• BitmapImage的相应子类创建不同格式的图像.
• PhotoImage用于PGM，PPM，GIF和PNG中的图像格式。从Tk 8.6开始支持后者.

通过file或data选项创建任何类型的图像（其他选项也可用）.

然后可以在image某些小部件支持选项（例如标签，按钮，菜单）。在这些情况下，Tk不会保持对图像的推断。当删除对图像对象的最后一个Python引用时，图像数据也会被删除，并且Tk将在使用图像的任何地方显示一个空框.