tkinter.messagebox — Сообщения Tkinter подсказывают

Источник: Lib/tkinter/messagebox.py


Модуль tkinter.messagebox предоставляет базовый класс шаблона, а также множество удобных методов для часто используемых конфигураций. Окна сообщений являются модальными и возвращают подмножество (True, False, None, OK, CANCEL, YES, NO) в зависимости от выбора пользователя. Общие стили и макеты окон сообщений включают, но не ограничиваются ими:

../_images/tk_msg.png
class tkinter.messagebox.Message(master=None, **options)

Создайте окно сообщения с заданным приложением сообщением, значком и набором кнопок. Каждая из кнопок в окне сообщения идентифицируется уникальным символическим именем (см. параметры type).

Поддерживаются следующие варианты:

команда

Указывает функцию, которую нужно вызвать, когда пользователь закрывает диалог. В качестве аргумента передается имя кнопки, на которую нажал пользователь, чтобы закрыть диалог. Эта функция доступна только для macOS.

по умолчанию

Указывает symbolic name кнопки по умолчанию для данного окна сообщений (OK, CANCEL и так далее). Если этот параметр не указан, то по умолчанию будет использоваться первая кнопка в диалоговом окне.

деталь

Указывает вспомогательное сообщение к основному сообщению, заданному опцией message. Детали сообщения будут представлены под основным сообщением и, если это поддерживается ОС, менее выделенным шрифтом, чем основное сообщение.

icon

Указывает значок icon для отображения. Если этот параметр не указан, то будет отображаться значок INFO.

сообщение

Указывает сообщение, которое будет отображаться в этом окне сообщений. По умолчанию используется пустая строка.

родитель

Делает указанное окно логическим родителем окна сообщения. Окно сообщения отображается поверх родительского окна.

title

Указывает строку для отображения в качестве заголовка окна сообщения. Этот параметр игнорируется в macOS, где руководство платформы запрещает использовать заголовок для такого рода диалогов.

тип

Устанавливает отображение predefined set of buttons.

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'