Диалоговые окна 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 предоставляет классы и фабричные функции для создания окон выбора файлов/каталогов.

Нативные диалоговые окна открытия/сохранения

Следующие классы и функции предоставляют диалоговые окна выбора файлов, сочетающие нативный вид с опциями конфигурации для настройки поведения. Следующие ключевые аргументы применимы к перечисленным ниже классам и функциям:

Статические фабричные функции

Вызов нижеприведённых функций создаёт модальное диалоговое окно с нативным видом, ожидает выбора пользователя, затем возвращает выбранное значение(я) или 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)

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(): Проверяет, предоставлен ли файл и указывает ли выбор уже существующий файл.

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

Подкласс FileDialog, создающий диалоговое окно для выбора файла назначения.

ok_command(): Проверяет, указывает ли выбор на действительный файл, который не является каталогом. Подтверждение требуется, если выбран уже существующий файл.

tkinter.commondialog — Шаблоны диалоговых окон

Исходный код: Lib/tkinter/commondialog.py

Модуль tkinter.commondialog предоставляет класс Dialog, который является базовым классом для диалоговых окон, определённых в других вспомогательных модулях.

class tkinter.commondialog.Dialog(master=None, **options)

show(color=None, **options): Отображает диалоговое окно.

См. также

Модули tkinter.messagebox, Чтение и запись файлов