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'