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

Родные диалоги загрузки/сохранения

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

parent - окно, поверх которого нужно поместить диалог
title - заголовок окна
initialdir - каталог, в котором начинается диалог
initialfile - файл, выбранный при открытии диалога
filetypes - последовательность кортежей (label, pattern), разрешен подстановочный знак „*“
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()

Проверьте, что файл предоставлен и что выбор указывает на уже существующий файл.

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

tkinter.font — Обертка для шрифтов Tkinter
tkinter.messagebox — подсказки сообщений Tkinter
Вернуться на верх