`tkinter.messagebox.md`

148 строк · 11.4 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.11/library/tkinter.messagebox.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`tkinter.messagebox`](https://python-all.ru/3.11/library/tkinter.messagebox.html#module-tkinter.messagebox) – диалоговые окна Tkinter89**Исходный код:** [Lib/tkinter/messagebox.py](https://python-all.ru/src/3.11/Lib/tkinter/messagebox.py)1011---1213Модуль [`tkinter.messagebox`](https://python-all.ru/3.11/library/tkinter.messagebox.html#module-tkinter.messagebox) предоставляет базовый класс-шаблон, а также несколько удобных методов для часто используемых конфигураций. Диалоговые окна сообщений являются модальными и возвращают подмножество (`True`, `False`, `None`, [`OK`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.OK), [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL), [`YES`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.YES), [`NO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.NO)) в зависимости от выбора пользователя. Распространённые стили и расположения диалоговых окон сообщений включают, но не ограничиваются:1415![../_images/tk_msg.png](https://python-all.ru/3.11/_images/tk_msg.png)1617#### `class tkinter.messagebox.Message(master=None, **options)`1819Создаёт окно сообщения с заданным приложением сообщением, значком и набором кнопок. Каждая кнопка в окне сообщения идентифицируется уникальным символическим именем (см. параметры *type*).2021Поддерживаются следующие параметры:2223> ***command***24>25> Задаёт функцию, которая вызывается при закрытии диалога пользователем. Имя кнопки, по которой пользователь щёлкнул для закрытия диалога, передаётся в качестве аргумента. Доступно только на macOS.26>27> ***default***28>29> Задаёт [символическое имя](https://python-all.ru/3.11/library/tkinter.messagebox.html#messagebox-buttons) кнопки по умолчанию для этого окна сообщения ([`OK`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.OK), [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL) и так далее). Если этот параметр не указан, первой кнопке в диалоге будет назначен статус по умолчанию.30>31> ***detail***32>33> Задаёт дополнительное сообщение к основному сообщению, заданному параметром *message*. Дополнительное сообщение будет отображаться под основным, и, где поддерживается ОС, шрифтом менее выделенным, чем основное сообщение.34>35> ***icon***36>37> Задаёт [значок](https://python-all.ru/3.11/library/tkinter.messagebox.html#messagebox-icons) для отображения. Если этот параметр не указан, будет отображаться значок [`INFO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.INFO).38>39> ***message***40>41> Задаёт сообщение для отображения в этом диалоговом окне. Значение по умолчанию – пустая строка.42>43> ***parent***44>45> Делает указанное окно логическим родителем диалогового окна. Диалоговое окно отображается поверх своего родительского окна.46>47> ***title***48>49> Задаёт строку для отображения в качестве заголовка диалогового окна. Этот параметр игнорируется на macOS, где рекомендации платформы запрещают использование заголовка в диалогах такого типа.50>51> ***тип***52>53> Организует отображение [заранее определённого набора кнопок](https://python-all.ru/3.11/library/tkinter.messagebox.html#messagebox-types).5455#### `show(**options)`5657Отображает окно сообщения и ожидает выбора пользователем одной из кнопок. Затем возвращает символическое имя выбранной кнопки. Именованные аргументы могут переопределять параметры, заданные в конструкторе.5859**Информационное диалоговое окно**6061#### `tkinter.messagebox.showinfo(title=None, message=None, **options)`6263Создаёт и отображает информационное диалоговое окно с указанными заголовком и сообщением.6465**Предупреждающие диалоговые окна**6667#### `tkinter.messagebox.showwarning(title=None, message=None, **options)`6869Создаёт и отображает предупреждающее диалоговое окно с указанными заголовком и сообщением.7071#### `tkinter.messagebox.showerror(title=None, message=None, **options)`7273Создаёт и отображает окно сообщения об ошибке с заданными заголовком и сообщением.7475**Окна вопросов**7677#### `tkinter.messagebox.askquestion(title=None, message=None, *, type=YESNO, **options)`7879Задаёт вопрос. По умолчанию показывает кнопки [`YES`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.YES) и [`NO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.NO). Возвращает символьное имя выбранной кнопки.8081#### `tkinter.messagebox.askokcancel(title=None, message=None, **options)`8283Спрашивает, следует ли продолжить операцию. Показывает кнопки [`OK`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.OK) и [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL). Возвращает `True`, если ответ положительный, и `False` в противном случае.8485#### `tkinter.messagebox.askretrycancel(title=None, message=None, **options)`8687Запрашивает, нужно ли повторить операцию. Показывает кнопки [`RETRY`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.RETRY) и [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL). Возвращает `True`, если ответ 'да', и `False` в противном случае.8889#### `tkinter.messagebox.askyesno(title=None, message=None, **options)`9091Задаёт вопрос. Показывает кнопки [`YES`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.YES) и [`NO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.NO). Возвращает `True`, если ответ «да», и `False` в противном случае.9293#### `tkinter.messagebox.askyesnocancel(title=None, message=None, **options)`9495Задаёт вопрос. Показывает кнопки [`YES`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.YES), [`NO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.NO) и [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL). Возвращает `True`, если ответ «да», `None` при отмене и `False` в противном случае.9697Символьные имена кнопок:9899#### `tkinter.messagebox.ABORT = 'abort'`100101#### `tkinter.messagebox.RETRY = 'retry'`102103#### `tkinter.messagebox.IGNORE = 'ignore'`104105#### `tkinter.messagebox.OK = 'ok'`106107#### `tkinter.messagebox.CANCEL = 'cancel'`108109#### `tkinter.messagebox.YES = 'yes'`110111#### `tkinter.messagebox.NO = 'no'`112113Предопределённые наборы кнопок:114115#### `tkinter.messagebox.ABORTRETRYIGNORE = 'abortretryignore'`116117Отображает три кнопки с символическими именами [`ABORT`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.ABORT), [`RETRY`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.RETRY) и [`IGNORE`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.IGNORE).118119#### `tkinter.messagebox.OK = 'ok'`120121Отображает одну кнопку с символьным именем [`OK`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.OK).122123#### `tkinter.messagebox.OKCANCEL = 'okcancel'`124125Отображает две кнопки с символьными именами [`OK`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.OK) и [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL).126127#### `tkinter.messagebox.RETRYCANCEL = 'retrycancel'`128129Отображает две кнопки с символьными именами [`RETRY`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.RETRY) и [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL).130131#### `tkinter.messagebox.YESNO = 'yesno'`132133Отображает две кнопки с символьными именами [`YES`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.YES) и [`NO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.NO).134135#### `tkinter.messagebox.YESNOCANCEL = 'yesnocancel'`136137Отображает три кнопки с символическими именами [`YES`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.YES), [`NO`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.NO) и [`CANCEL`](https://python-all.ru/3.11/library/tkinter.messagebox.html#tkinter.messagebox.CANCEL).138139Изображения значков:140141#### `tkinter.messagebox.ERROR = 'error'`142143#### `tkinter.messagebox.INFO = 'info'`144145#### `tkinter.messagebox.QUESTION = 'question'`146147#### `tkinter.messagebox.WARNING = 'warning'`148