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'