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'