25、顶级窗口 方法Toplevel

w.after(delay_ms, callback=None, *args)

请求 Tkinter 在延迟 at 后调用带有参数的函数 最少毫秒。多长时间没有上限 实际上会接受，但不会调用您的回调 比您请求的要早，并且只会调用它 一次。callbackargsdelay_ms

此方法返回一个整数“之后 标识符“，如果要取消，可以传递给方法 回调。.after_cancel()

如果不传递参数，此方法将等待毫秒，就像在标准 Python 时间模块的函数中一样。callbackdelay_ms.sleep()

w.after_cancel(id)

取消之前设置的回调请求。参数是 原始 .after（） 调用返回的结果。.after()id

w.after_idle(func, *args)

请求 Tkinter 调用函数 参数 下次系统空闲时，即下一个 时间没有要处理的事件。这 回调只会被调用一次。如果你想要你的 要再次调用回调，必须再次调用该方法。funcargs.after_idle

w.bell()

发出声音，通常是哔哔声。

w.bind(sequence=None, func=None, add=None)

此方法用于将事件绑定附加到 控件。有关概述，请参见第 54 节 “事件” 的事件绑定。

参数描述了我们期望的事件，参数是当该事件时要调用的函数 发生在小部件上。如果已经有一个 此小部件的该事件的绑定，通常是 旧回调替换为 ，但您可以 通过传递 来保留两个回调。sequencefuncfuncadd='+'

w.bind_all(sequence=None, func=None, add=None)

喜欢 ，但适用于所有 整个应用程序中的小部件。.bind()

w.bind_class(className, sequence=None, func=None, add=None)

喜欢 ，但适用于所有 命名的小部件（例如，）。.bind()className'Button'

w.bindtags(tagList=None)

如果调用此方法，它将返回 小部件的“绑定标签”作为 字符串序列。绑定标记是 窗口（以“.”开头） 或类的名称（例如，）。'Listbox'

您可以更改绑定级别的顺序 通过将序列作为参数传递来调用 您希望小组件使用的绑定标签。

有关 绑定级别及其与标记的关系。

w.cget(option)

返回 作为 字符串。您还可以获取以下选项的值 小部件作为 。optionww[option]

w.clipboard_append(text)

将给定的字符串追加到 显示器的剪贴板，其中剪切和粘贴字符串 为该显示器的所有应用程序存储。text

w.clipboard_clear()

清除显示器的剪贴板（见上文）。.clipboard_append()

w.column_configure()

请参见第 4.2 节 “其他网格管理方法”。

w.config(option=value, ...)

与 相同。.configure()

w.configure(option=value, ...)

设置一个或多个选项的值。对于 名称为 Python 保留字的选项 （， ， ）， 使用尾随下划线： ， ， .classfromin'class_''from_''in_'

您还可以使用语句设置小部件选项的值w

 w [ option ] = value 

如果在 没有参数的小部件，你会得到一个字典 所有小部件的当前选项。键是 选项名称（包括别名，如 ）。的值 每个键是：.config()bdborderwidth

w.destroy()

调用小部件会破坏其所有子项。w.destroy()ww

w.event_add(virtual, *sequences)

此方法创建一个名称为 由字符串给出 论点。每个附加参数描述一个序列，即 物理事件的描述。当该事件 发生时，将触发新的虚拟事件。virtual

见第 54 节 “事件”了解一般情况 虚拟活动的描述。

w.event_delete(virtual, *sequences)

从其虚拟事件中删除物理事件 名称由字符串 给出。如果全部 从给定的虚拟中删除物理事件 事件，该虚拟事件将不再发生。virtual

w.event_generate(sequence, **kw)

此方法会导致事件在没有任何的情况下触发 外部刺激。事件的处理是 与外部触发相同 刺激物。论点 描述要触发的事件。您可以设置 通过提供参数为对象中的选定字段提供值， 其中指定 对象中字段的名称。sequenceEventkeyword=valuekeywordEvent

有关 54 节 “事件”的完整讨论，请参见 事件。

w.event_info(virtual=None)

如果在没有参数的情况下调用此方法，则将 获取当前定义的所有序列 虚拟活动名称。

检索与 虚拟事件，将此方法的名称传递给 虚拟事件，您将获得一系列 物理名称， 或者如果给定的虚拟活动有 从未定义过。sequenceNone

w.focus_displayof()

返回当前具有的窗口的名称 输入焦点与微件位于同一显示器上。如果没有 这样的窗口具有输入焦点，返回 .None

有关一般说明，请参见第 53 节 “焦点：路由键盘输入” 的输入焦点。

w.focus_force()

强制将输入焦点设置为微件。这是 不礼貌。最好等待窗口管理器 给你重点。另请参阅下文。.grab_set_global()

w.focus_get()

返回在此具有焦点的小组件 应用程序（如果有），否则返回 。None

w.focus_lastfor()

此方法检索小部件的名称 最后在顶级窗口中具有输入焦点 包含。如果没有此顶级小部件 曾经有过输入焦点，它返回 顶级小部件。如果此应用程序没有 输入焦点，将 返回将获得焦点的小部件的名称 下次回到此应用程序时。w.focus_lastfor()

w.focus_set()

如果 的应用程序具有输入焦点，则焦点 将跳转到 。如果 的应用程序没有 有重点，Tk会记得给下一个 应用程序获得焦点。wwww

w.grab_current()

如果 显示时有抓斗力， 返回其标识符，否则返回 .请参阅第 54 节 “事件” 关于抢夺的讨论。wNone

w.grab_release()

如果有抓斗，请松开它。w

w.grab_set()

小部件抓取 的所有事件 应用。如果有另一个抢夺，它 走开了。有关 第 54 节 “事件”，请参见 讨论抢夺。ww

w.grab_set_global()

小部件抓取整个屏幕的所有事件。 这被认为是不礼貌的，只能使用 非常需要。任何其他有效的抢夺都会消失。 尝试只将这种可怕的力量用于 善良，从不为邪恶势力服务，好吗？w

w.grab_status()

如果存在本地抓取（由 设置），则此方法返回字符串。如果有全局抓取 力（来自），它 返回。如果没有抓取 力，它返回..grab_set()'local'.grab_set_global()'global'None

w.grid_forget()

请参见第 4.2 节 “其他网格管理方法”。

w.grid_propagate()

请参见第 4.2 节 “其他网格管理方法”。

w.grid_remove()

请参见第 4.2 节 “其他网格管理方法”。

w.image_names()

返回 中所有图像的名称 应用程序作为字符串序列。w

w.keys()

以序列形式返回小组件的选项名称 的字符串。

w.lift(aboveThis=None)

如果参数为 ，则窗口 包含被移动到窗口顶部 堆叠顺序。要将窗口移动到某个窗口上方，作为参数传递。NonewToplevelww

w.lower(belowThis=None)

如果参数为 ，则窗口 包含被移动到窗口底部 堆叠顺序。要将窗口移动到某个窗口的正下方，请作为参数传递。NonewToplevelww

w.mainloop()

必须调用此方法，通常毕竟 创建静态小部件，以开始处理 事件。您可以使用该方法（如下）保留主循环。您也可以致电 此方法在事件处理程序中恢复 主循环。.quit()

w.nametowidget(name)

此方法返回路径名的实际小部件 是。 请参见第 5.11 节 “窗口名称”。如果 未知，此方法将引发.namenameKeyError

w.option_add(pattern, value, priority=None)

此方法将默认选项值添加到 Tkinter 选项数据库。这是一个 指定选项默认值的字符串 的一个或多个小部件。价值观 是以下之一：patternvaluepriority

更高级别的优先级优先于 较低级别的。有关 选项数据库。参数的语法 to 与资源规范行的一部分相同。pattern.option_add()option-pattern

例如，要获得此资源的效果 规格线：

 *Button*font: times 24 bold

您的应用程序（在此 示例）可能包括以下行：self

   self.bigFont = tkFont.Font(family='times', size=24, weight='bold')self.option_add('*Button*font', self.bigFont)

之后创建的任何小部件 执行这些行将默认为粗体 Times 24 字体（除非被构造函数的选项覆盖）。ButtonfontButton

w.option_clear()

此方法从 Tkinter 选项数据库中删除所有选项。这具有回溯的效果 到所有默认值。

w.option_get(name, classname)

使用此方法检索 来自 Tkinter 选项数据库的选项。第一个 参数是实例键和第二个参数 是类键。如果有任何匹配项，则 返回最匹配的选项的值。 如果没有匹配项，则返回 。''

有关更多信息，请参见第 27 节 “标准化外观” 关于键与选项的匹配方式。

w.option_readfile(fileName, priority=None)

为了方便用户配置，您可以指定 一个命名文件，用户可以在其中放置他们的首选选项， 使用与文件相同的格式。然后，当你的 应用程序正在初始化，您可以传递该文件的名称 到此方法，该文件中的选项将是 添加到数据库中。如果文件不存在，或者 格式无效，此方法将引发 ..Xdefaultstk.TclError

请参阅第 27 节 “标准化外观” 选项数据库和格式简介 的选项文件。

w.register(function)

此方法围绕 Python 函数创建一个 Tcl 包装器，并返回 Tcl 字符串形式的包装器名称。有关用法的示例 此方法，请参见第 10.2 节 “向条目小部件添加验证”。

w.quit()

此方法退出主循环。有关主要内容的讨论，请参见上文 循环。.mainloop()

w.rowconfigure()

请参见第 4.2 节 “其他网格管理方法”。

w.selection_clear()

如果当前有一个选择（例如 条目小部件中突出显示的文本片段）， 清除该选择。w

w.selection_get()

如果当前有选择，则此方法 返回所选文本。如果没有选择， 它提高了.wtk.TclError

w.selection_own()

在 中指定所选内容的所有者 显示，从以前的所有者那里窃取它，如果有的话。ww

w.selection_own_get()

返回当前拥有所选内容的小部件。如果提高，则 没有这样的选择。wtk.TclError

w.tk_focusFollowsMouse()

通常，输入焦点在一个序列中循环 由其层次结构和创建决定的小部件 次序;请参见第 53 节 “焦点：路由键盘输入”。您可以 相反，告诉特金特强制焦点是 无论鼠标在哪里;只需调用此方法。那里 但是，要撤消它并不容易。

w.tk_focusNext()

返回焦点中后面的小组件 遍历序列。有关焦点遍历的讨论，请参见第 53 节 “焦点：路由键盘输入”。w

w.tk_focusPrev()

返回焦点中前面的小组件 遍历序列。w

w.unbind(sequence, funcid=None)

此方法删除事件的绑定 由 描述。如果 第二个参数是绑定到该序列的回调， 该回调被删除，其余的（如果有）是 留在原地。如果省略第二个参数， 删除所有绑定。wsequence

见下文第54节“事件”，了解一般情况 讨论事件绑定。

w.unbind_all(sequence)

删除整个应用程序中的所有事件绑定 对于给定 描述的事件。sequence

w.unbind_class(className, sequence)

喜欢 ，但适用于所有 命名的小部件（例如，或 ）。.unbind()className'Entry''Listbox'

w.update()

此方法强制更新显示。它 只有在你知道自己在做什么时才应该使用， 因为它可能导致不可预测的行为或 循环。永远不应该从事件中调用它 回调或从事件调用的函数 回调。

w.update_idletasks()

更新显示中的一些任务，例如调整大小 和重绘小部件，称为空闲 任务，因为它们通常会延迟 直到应用程序完成事件处理 并已返回主循环等待新的 事件。

如果要强制在之前更新显示 应用程序接下来空闲，在任何 控件。w.update_idletasks()

w.wait_variable(v)

等待变量的值设置完毕，即使该值 不会改变。此方法进入本地等待 循环，因此它不会阻塞其余部分 应用。v

w.wait_visibility(w)

等到小部件（通常为 ）是 可见。wToplevel

w.wait_window(w)

等到窗口被破坏。w

w.winfo_children()

返回所有 子项的列表，在其 堆叠顺序从最低（底部）到最高（顶部）。w

w.winfo_class()

返回 的类名（例如，）。w'Button'

w.winfo_containing(rootX, rootY, displayof=0)

此方法用于查找包含以下内容的窗口 点 （， ）。 如果该选项为 false，则 坐标相对于应用程序的根目录 窗;如果为 true，则坐标被视为 相对于包含 的顶级窗口。 如果指定的点位于应用程序的某个 顶级窗口，此方法返回该窗口; 否则返回 .rootXrootYdisplayofwNone

w.winfo_depth()

返回 中每像素的位数 显示。w

w.winfo_fpixels(number)

对于任何维度（请参见第 5.1 节 “维度”），此方法 在 的显示屏上以像素为单位返回该距离，作为 类型数 .numberwfloat

w.winfo_geometry()

返回描述大小和 的屏幕位置。请参见第 5.10 节 “几何字符串”。w

w.winfo_height()

返回当前高度（以像素为单位）。看 上文 下关于几何更新的注释。您可能更喜欢 用法 ，描述 下面，始终是最新的。w.winfo_geometry().winfo_reqheight()

w.winfo_id()

返回在其顶级窗口中唯一标识的整数。您将需要这个 方法，如下。w.winfo_pathname()

w.winfo_ismapped()

此方法返回 true，如果映射，则返回 false 否则。如果微件已格网化，则会对其进行映射 （或放置或包装，如果您使用的是 其他几何体管理器）加入其父级，如果其 父级映射，依此类推，直至顶层 窗。w

w.winfo_manager()

如果尚未网格化（或通过以下之一放置 其他几何管理器），此方法返回一个 空字符串。如果已被网格化或其他方式 放置，它返回一个命名几何图形的字符串 的管理器：此值将是 、 、 或 中的一个。www'grid''pack''place''canvas''text'

w.winfo_name()

此方法返回相对于其 的名称 父母。请参见第 5.11 节 “窗口名称”。也 请参阅下面的 ，以查找 了解如何获取小部件的路径名。w.winfo_pathname()

w.winfo_parent()

返回父级的路径名，或空 字符串 if 是顶级窗口。有关小部件的更多信息，请参见上面的第 5.11 节 “窗口名称” 路径名。ww

w.winfo_pathname(id, displayof=0)

如果参数为 false，则返回窗口路径名 具有唯一标识符的小部件 应用程序的主窗口。如果是 True，该数字指定同一顶级中的小部件 窗口作为 。有关小部件路径名的讨论，请参见第 5.11 节 “窗口名称”。displayofiddisplayofidw

w.winfo_pixels(number)

对于任何维度（请参阅 尺寸，如上），此方法返回该距离 以 显示的像素为单位，作为整数。numberw

w.winfo_pointerx()

返回与坐标相同的值 返回者 。x.winfo_pointerxy()

w.winfo_pointerxy()

返回一个元组，其中包含 鼠标指针相对于 的坐标 根窗口。如果鼠标指针不在同一位置 屏幕，返回 。(x, y)w(-1, -1)

w.winfo_pointery()

返回与坐标相同的值 返回者 。y.winfo_pointerxy()

w.winfo_reqheight()

这些方法返回小部件的请求高度。这是所需的最小高度，以便 的所有内容都有他们需要的房间。这 实际高度可能因协商而有所不同 使用几何管理器。ww

w.winfo_reqwidth()

返回小部件的请求宽度， 包含 所需的最小宽度。与 .winfo_reqheight（） 一样，实际宽度 由于与 几何管理器。ww

w.winfo_rgb(color)

对于任何给定的颜色，此方法返回 等效的红-绿-蓝颜色规格为 3元组，其中每个元组 数字是 [0， 65536] 范围内的整数。为 例如，如果 is ，则此方法返回 3 元组。(r, g, b)color'green'(0, 65535, 0)

有关指定颜色的更多信息，请参见第 5.3 节 “颜色”。

w.winfo_rootx()

返回 根目录左侧的坐标 相对于 父级的窗口。xww

如果有边框，这是 边境。w

w.winfo_rooty()

返回 根窗口顶部的坐标 相对于 的父级。yww

如果有边框，这是 边境。w

w.winfo_screenheight()

返回屏幕的高度（以像素为单位）。

w.winfo_screenmmheight()

返回屏幕的高度（以毫米为单位）。

w.winfo_screenmmwidth()

返回屏幕的宽度（以毫米为单位）。

w.winfo_screenvisual()

返回描述显示方法的字符串 的色彩再现。这通常用于 16 位或 24 位显示器，适用于 256 色显示器。'truecolor''pseudocolor'

w.winfo_screenwidth()

返回屏幕的宽度（以像素为单位）。

w.winfo_toplevel()

返回包含 的顶级窗口。那 窗口支持小部件上的所有方法;请参见第 25 节 “顶级：顶级窗口” 方法”。wToplevel

w.winfo_viewable()

返回值的谓词 如果可见，也就是说，如果它及其所有 同的祖先是 映射。TruewToplevel

w.winfo_width()

返回 的当前宽度（以像素为单位）。看 上文 下关于几何更新的注释。您可能更喜欢 使用该方法， 上述;它始终是最新的。w.winfo_geometry().winfo_reqwidth()

w.winfo_x()

返回 的左侧相对于 的坐标 它的父级。如果有边框，这是外部 边界的边缘。xww

w.winfo_y()

返回 的顶边相对于其 的坐标 父母。如果有边框，这是外部 边界的边缘。yww