Tkinter 对话框

tkinter.simpledialog — 标准 Tkinter 输入对话框

源代码: Lib/tkinter/simpledialog.py


tkinter.simpledialog 模块包含用于创建简单模态对话框以从用户获取值的便捷类和函数。

tkinter.simpledialog.askfloat(title, prompt, **kw)
tkinter.simpledialog.askinteger(title, prompt, **kw)
tkinter.simpledialog.askstring(title, prompt, **kw)

以上三个函数提供提示用户输入所需类型值的对话框。

class tkinter.simpledialog.Dialog(parent, title=None)

自定义对话框的基类。

body(master)

覆盖以构建对话框的界面并返回应具有初始焦点的窗口小部件。

buttonbox()

默认行为添加确定和取消按钮。覆盖以实现自定义按钮布局。

tkinter.filedialog — 文件选择对话框

源代码: Lib/tkinter/filedialog.py


tkinter.filedialog 模块提供用于创建文件/目录选择窗口的类和工厂函数。

原生加载/保存对话框

以下类和函数提供文件对话框窗口,这些窗口结合了原生外观和感觉,以及用于自定义行为的配置选项。以下关键字参数适用于下面列出的类和函数

parent - 用于放置对话框的窗口
title - 窗口的标题
initialdir - 对话框启动的目录
initialfile - 对话框打开时选定的文件
filetypes - (标签、模式)元组的序列,“*”通配符是允许的
defaultextension - 要附加到文件(保存对话框)的默认扩展名
multiple - 为 true 时,允许选择多个项目

静态工厂函数

调用以下函数时,会创建一个模态原生外观和感觉的对话框,等待用户选择,然后将所选值或 None 返回给调用者。

tkinter.filedialog.askopenfile(mode='r', **options)
tkinter.filedialog.askopenfiles(mode='r', **options)

以上两个函数创建一个 Open 对话框,并以只读模式返回打开的文件对象。

tkinter.filedialog.asksaveasfile(mode='w', **options)

创建一个 SaveAs 对话框,并返回一个以只写模式打开的文件对象。

tkinter.filedialog.askopenfilename(**options)
tkinter.filedialog.askopenfilenames(**options)

以上两个函数创建一个 Open 对话框,并返回与现有文件相对应的选定文件名。

tkinter.filedialog.asksaveasfilename(**options)

创建一个 SaveAs 对话框,并返回选定的文件名。

tkinter.filedialog.askdirectory(**options)
提示用户选择一个目录。
其他关键字选项
mustexist - 确定选择是否必须是现有目录。
class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)

以上两个类为保存和加载文件提供了本机对话框窗口。

便捷类

以下类用于从头创建文件/目录窗口。这些类不会模拟平台的原生外观和感觉。

class tkinter.filedialog.Directory(master=None, **options)

创建一个对话框,提示用户选择一个目录。

注意

FileDialog 类应被子类化为自定义事件处理和行为。

class tkinter.filedialog.FileDialog(master, title=None)

创建一个基本的文件选择对话框。

cancel_command(event=None)

触发对话框窗口的终止。

dirs_double_event(event)

目录上双击事件的事件处理程序。

dirs_select_event(event)

目录上单击事件的事件处理程序。

files_double_event(event)

文件上双击事件的事件处理程序。

files_select_event(event)

文件上单击事件的事件处理程序。

filter_command(event=None)

按目录过滤文件。

get_filter()

检索当前正在使用的文件筛选器。

get_selection()

检索当前选定的项。

go(dir_or_file=os.curdir, pattern='*', default='', key=None)

呈现对话框并启动事件循环。

ok_event(event)

退出对话框,返回当前选择。

quit(how=None)

退出对话框,返回文件名(如果有)。

set_filter(dir, pat)

设置文件筛选器。

set_selection(file)

将当前文件选择更新为file

class tkinter.filedialog.LoadFileDialog(master, title=None)

FileDialog 的子类,用于创建用于选择现有文件的对话框窗口。

ok_command()

测试是否提供了文件,并且选择指示已经存在的文件。

tkinter.filedialog.SaveFileDialog(master, title=)

FileDialog 的一个子类,它创建一个对话框窗口,用于选择目标文件。

ok_command()

测试选择是否指向一个有效的非目录文件。如果选择了已存在的文件,则需要确认。

tkinter.commondialog — 对话框窗口模板

源代码: Lib/tkinter/commondialog.py


tkinter.commondialog 模块提供了 Dialog 类,它是其他支持模块中定义的对话框的基本类。

tkinter.commondialog.Dialog(master=, **options)
show(color=, **options)

渲染对话框窗口。