Диалоги 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, Чтение и запись файлов