tkinter.messagebox — диалоговые окна сообщений Tkinter

Исходный код: 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 этот параметр игнорируется, поскольку рекомендации платформы запрещают использовать заголовок в диалоговых окнах такого типа.

type

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

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'