Диалоговые окна 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(): По умолчанию добавляются кнопки OK и Cancel. Переопределите метод, чтобы настроить расположение кнопок.

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): Отображает окно Dialog.

См. также

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