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 если ответ «ok», и 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'