Tkinter 对话框¶
tkinter.simpledialog
— 标准 Tkinter 输入对话框¶
源代码: Lib/tkinter/simpledialog.py
tkinter.simpledialog
模块包含用于创建简单的模态对话框以从用户获取值的便利类和函数。
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.askopenfilename(**options)¶
- tkinter.filedialog.askopenfilenames(**options)¶
以上两个函数创建一个
Open
对话框,并返回与现有文件对应的选定文件名。
- 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*。
tkinter.commondialog
— 对话框窗口模板¶
源代码: Lib/tkinter/commondialog.py
tkinter.commondialog
模块提供了 Dialog
类,它是其他支持模块中定义的对话框的基类。
另请参阅