tkinter.messagebox – диалоговые окна Tkinter¶tkinter.messagebox – Tkinter message prompts

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

Модуль tkinter.messagebox предоставляет базовый класс-шаблон, а также несколько удобных методов для часто используемых конфигураций. Диалоговые окна сообщений являются модальными и возвращают подмножество (True, False, None, OK, CANCEL, YES, NO) в зависимости от выбора пользователя. Распространённые стили и расположения диалоговых окон сообщений включают, но не ограничиваются:

class tkinter.messagebox.Message(master=None, **options)¶

Создаёт окно сообщения с заданным приложением сообщением, значком и набором кнопок. Каждая кнопка в окне сообщения идентифицируется уникальным символическим именем (см. параметры type).

Поддерживаются следующие параметры:

command

Задаёт функцию, которая вызывается при закрытии диалога пользователем. Имя кнопки, по которой пользователь щёлкнул для закрытия диалога, передаётся в качестве аргумента. Доступно только на macOS.

default

Задаёт символическое имя кнопки по умолчанию для этого окна сообщения (OK, CANCEL и так далее). Если этот параметр не указан, первой кнопке в диалоге будет назначен статус по умолчанию.

detail

Задаёт дополнительное сообщение к основному сообщению, заданному параметром message. Дополнительное сообщение будет отображаться под основным, и, где поддерживается ОС, шрифтом менее выделенным, чем основное сообщение.

icon

Задаёт значок для отображения. Если этот параметр не указан, будет отображаться значок INFO.

message

Задаёт сообщение для отображения в этом диалоговом окне. Значение по умолчанию – пустая строка.

parent

Делает указанное окно логическим родителем диалогового окна. Диалоговое окно отображается поверх своего родительского окна.

title

Задаёт строку для отображения в качестве заголовка диалогового окна. Этот параметр игнорируется на macOS, где рекомендации платформы запрещают использование заголовка в диалогах такого типа.

тип

Организует отображение заранее определённого набора кнопок.

show(**options)¶

Отображает окно сообщения и ожидает выбора пользователем одной из кнопок. Затем возвращает символическое имя выбранной кнопки. Именованные аргументы могут переопределять параметры, заданные в конструкторе.

Информационное диалоговое окно

tkinter.messagebox.showinfo(title=None, message=None, **options)¶

Создаёт и отображает информационное диалоговое окно с указанными заголовком и сообщением.

Предупреждающие диалоговые окна

tkinter.messagebox.showwarning(title=None, message=None, **options)¶

Создаёт и отображает предупреждающее диалоговое окно с указанными заголовком и сообщением.

tkinter.messagebox.showerror(title=None, message=None, **options)¶

Создаёт и отображает окно сообщения об ошибке с заданными заголовком и сообщением.

Окна вопросов

tkinter.messagebox.askquestion(title=None, message=None, *, type=YESNO, **options)¶

Задаёт вопрос. По умолчанию показывает кнопки YES и NO. Возвращает символьное имя выбранной кнопки.

tkinter.messagebox.askokcancel(title=None, message=None, **options)¶

Спрашивает, следует ли продолжить операцию. Показывает кнопки OK и CANCEL. Возвращает True, если ответ положительный, и False в противном случае.

tkinter.messagebox.askretrycancel(title=None, message=None, **options)¶

Запрашивает, нужно ли повторить операцию. Показывает кнопки RETRY и CANCEL. Возвращает True, если ответ 'да', и False в противном случае.

tkinter.messagebox.askyesno(title=None, message=None, **options)¶

Задаёт вопрос. Показывает кнопки YES и NO. Возвращает True, если ответ «да», и False в противном случае.

tkinter.messagebox.askyesnocancel(title=None, message=None, **options)¶

Задаёт вопрос. Показывает кнопки YES, NO и CANCEL. Возвращает True, если ответ «да», None при отмене и False в противном случае.

Символьные имена кнопок:

tkinter.messagebox.ABORT = 'abort'¶

tkinter.messagebox.RETRY = 'retry'¶

tkinter.messagebox.IGNORE = 'ignore'¶

tkinter.messagebox.OK = 'ok'¶

tkinter.messagebox.CANCEL = 'cancel'¶

tkinter.messagebox.YES = 'yes'¶

tkinter.messagebox.NO = 'no'¶

Предопределённые наборы кнопок:

tkinter.messagebox.ABORTRETRYIGNORE = 'abortretryignore'¶

Отображает три кнопки с символическими именами ABORT, RETRY и IGNORE.

tkinter.messagebox.OK = 'ok'

Отображает одну кнопку с символьным именем OK.

tkinter.messagebox.OKCANCEL = 'okcancel'¶

Отображает две кнопки с символьными именами OK и CANCEL.

tkinter.messagebox.RETRYCANCEL = 'retrycancel'¶

Отображает две кнопки с символьными именами RETRY и CANCEL.

tkinter.messagebox.YESNO = 'yesno'¶

Отображает две кнопки с символьными именами YES и NO.

tkinter.messagebox.YESNOCANCEL = 'yesnocancel'¶

Отображает три кнопки с символическими именами YES, NO и CANCEL.

Изображения значков:

tkinter.messagebox.ERROR = 'error'¶

tkinter.messagebox.INFO = 'info'¶

tkinter.messagebox.QUESTION = 'question'¶

tkinter.messagebox.WARNING = 'warning'¶