msgbox

Создайте диалоговое окно сообщения

Если вы используете App Designer или создаете приложения с функцией uifigure, то используйте uialert вместо этого. Для получения дополнительной информации см. Мигрирующие Приложения GUIDE к App Designer.

Синтаксис

f = msgbox(message)

f = msgbox(message,title)

f = msgbox(message,title,icon)

f = msgbox(message,title,'custom',icondata,iconcmap)

f = msgbox(___,createmode)

Описание

пример

f = msgbox(message) создает диалоговое окно сообщения, которое автоматически переносит message, чтобы соответствовать соответственно размерной фигуре.

пример

f = msgbox(message,title) задает заголовок окна сообщения.

пример

f = msgbox(message,title,icon) задает предопределенный значок, чтобы отобразиться в диалоговом окне сообщения.

пример

f = msgbox(message,title,'custom',icondata,iconcmap) задает пользовательский значок, чтобы включать в диалоговое окно сообщения. icondata является данными изображения, которые задают значок. iconcmap является палитрой, используемой для изображения. Если icondata является матрицей изображений истинного цвета, вы не должны задавать iconcmap.

пример

f = msgbox(___,createmode) задает режим окна для диалогового окна. Также можно задать массив структур, который задает режим окна и интерпретатор для message.

Примеры

свернуть все

Простое диалоговое окно сообщения

Задайте текст, который вы хотите отображенный в диалоговом окне сообщения.

f = msgbox('Operation Completed');

Обмен сообщениями текста диалогового окна с разрывами строки

Задайте текст диалогового окна сообщения с помощью массива ячеек из символьных векторов.

f = msgbox({'Operation';'Completed'});

Обмен сообщениями диалогового окна с заголовком

Задайте текст диалогового окна сообщения и дайте диалоговому окну заголовок, Success.

f = msgbox('Operation Completed','Success');

Диалоговое окно Message, которое использует встроенный значок

Включайте встроенный значок ошибки с сообщением об ошибке по названной Ошибке диалогового окна сообщения.

f = msgbox('Invalid Value', 'Error','error');

Передайте диалоговое окно, которое использует пользовательский значок истинного цвета

Считайте изображение RGB в рабочую область. Затем задайте его как пользовательский значок в диалоговом окне.

myicon = imread('landOcean.jpg');
h=msgbox('Operation Completed','Success','custom',myicon);

Передайте диалоговое окно, которое использует значок индексированного цвета

Считайте данные изображения и палитру в рабочую область.

[icondata,iconcmap] = imread('trees.tif');

Создайте диалоговое окно сообщения, включая пользовательский значок.

h=msgbox('Operation Completed',...
         'Success','custom',icondata,iconcmap);

Настройте цвета изображения путем определения различной палитры. Например, задайте MATLAB^® встроенная палитра, summer

h=msgbox('Operation Completed','Success','custom',...
          icondata,summer);

Модальное диалоговое окно сообщения

Создайте модальное диалоговое окно сообщения, перенеся вызов msgbox с uiwait, чтобы сделать выполнение блока MATLAB диалогового окна сообщения, пока пользователь не ответит на диалоговое окно сообщения.

uiwait(msgbox('Operation Completed','Success','modal'));

Модальное диалоговое окно сообщения, которое использует форматированное сообщение TeX

Создайте структуру, чтобы указать, что пользователь должен нажать ОК прежде, чем взаимодействовать с другим окном и что MATLAB интерпретирует текст сообщения как формат TeX.

CreateStruct.Interpreter = 'tex';
CreateStruct.WindowStyle = 'modal';

Создайте диалоговое окно сообщения.

h=msgbox('Z = X^2 + Y^2','Value',CreateStruct);

Входные параметры

свернуть все

`сообщение` Текст диалогового окна
вектор символов | массив ячеек из символьных векторов | массив строк

Текст диалогового окна, заданный как вектор символов, массив ячеек из символьных векторов или массив строк.

Пример: 'Operation Completed'

Пример: {'Operation'; 'Completed'}

`заголовок` Заголовок
вектор символов | представляет скаляр в виде строки

Заголовок, заданный как вектор символов или скаляр строки.

Пример: 'Success'

`значок` Значок
`'none'` (значение по умолчанию) | `'help'` | `'warn'` | `'error'` | `'custom'`

Значок, заданный как 'help', 'warn', или 'error' или 'none'.

Эта таблица приводит значения и соответствующие значки.

Значение	Значок
`'help'`
`'warn'`
`'error'`
`'none'`	Никакие отображения значка.

`iconData` Матрица изображений
массив m на n | m n 3 матрицами изображений истинного цвета

Матрица изображений, заданная как массив m на n или m n 3 матрицами изображений истинного цвета. Можно также использовать imread, чтобы получить матрицу изображений от файла.

`iconCMap` Палитра
матрица с тремя столбцами триплетов RGB

Палитра, заданная как матрица с тремя столбцами триплетов RGB. Триплет RGB является трехэлементным вектором - строкой, элементы которого задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0, 1].

Типы данных: single | double

Режим `createmode` — Window
`'non-modal'` (значение по умолчанию) | `'modal'` | `'replace'` | массив структур

Режим Window, заданный как 'non-modal', 'modal', 'replace' или массив структур.

Если createmode является 'non-modal', MATLAB создает новое немодальное окно сообщения с заданными параметрами. Остаются существующие окна сообщения с тем же title.
Если createmode является 'modal', MATLAB заменяет существующее окно сообщения на заданный title, который был в последний раз создан или нажат с заданным модальным диалоговым окном. MATLAB удаляет все другие окна сообщения с тем же заголовком. Замененное окно сообщения может быть или модальным или немодальным.
Если createmode является 'replace', MATLAB заменяет окно сообщения, имеющее заданный title, который был в последний раз создан или нажат с немодальным окном сообщения, как задано. MATLAB удаляет все другие окна сообщения с тем же заголовком. Замененное окно сообщения может быть или модальным или немодальным.
Если createmode является массивом структур, он должен иметь поля WindowStyle и Interpreter. Значением поля WindowStyle должен быть 'non-modal', 'modal' или 'replace'. Значением поля Interpreter должен быть 'tex' или 'none'. Если значением Interpreter является 'tex', MATLAB интерпретирует значение message как Техас. Значением по умолчанию для Interpreter является 'none'.

TeX Markup

По умолчанию MATLAB поддерживает подмножество разметки TeX. Используйте синтаксис TeX, чтобы добавить верхние индексы и индексы, изменить тип шрифта и окрасить и включать специальные символы в текст.

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете свойство Interpreter на 'tex', поддерживаемые модификаторы следующие.

Модификатор	Описание	Пример
`^{ }`	Верхний индекс	`'text^{superscript}'`
`_{ }`	Индекс	`'text_{subscript}'`
`\bf`	Bold font	`'\bf text'`
`\it`	Курсивный шрифт	`'\it text'`
`\sl`	Наклонный шрифт (обычно то же самое как курсивный шрифт)	`'\sl text'`
`\rm`	Обычный шрифт	`'\rm text'`
`\fontname{specifier}`	Название шрифта — Замена `specifier` с именем семейства шрифтов. Можно использовать это в сочетании с другими модификаторами.	`'\fontname{Courier} text'`
`\fontsize{specifier}`	Размер шрифта — Замена `specifier` со значением числового скаляра в модулях точки.	`'\fontsize{15} text'`
`\color{specifier}`	Цвет шрифта — Замена `specifier` с одним из этих цветов: `red`, `green`, `yellow`, `magenta`, `blue`, `black`, `white`, `gray`, `darkGreen`, `orange` или `lightBlue`.	`'\color{magenta} text'`
`\color[rgb]{specifier}`	Цвет пользовательского шрифта — Замена `specifier` с трехэлементным триплетом RGB.	`'\color[rgb]{0,0.5,0.5} text'`

В этой таблице перечислены поддерживаемые специальные символы со свойством Interpreter, установленным на 'tex'.

Последовательность символов	Символ	Последовательность символов	Символ	Последовательность символов	Символ
`\alpha`	α	`\upsilon`	υ	`\sim`	~
`\angle`	∠	`\phi`		`\leq`	≤
`\ast`	`*`	`\chi`	χ	`\infty`	∞
`\beta`	β	`\psi`	ψ	`\clubsuit`	♣
`\gamma`	γ	`\omega`	ω	`\diamondsuit`	♦
`\delta`	δ	`\Gamma`	Γ	`\heartsuit`	♥
`\epsilon`	ϵ	`\Delta`	Δ	`\spadesuit`	♠
`\zeta`	ζ	`\Theta`	Θ	`\leftrightarrow`	↔
`\eta`	η	`\Lambda`	Λ	`\leftarrow`	←
`\theta`	θ	`\Xi`	Ξ	`\Leftarrow`	⇐
`\vartheta`	ϑ	`\Pi`	Π	`\uparrow`	↑
`\iota`	ι	`\Sigma`	Σ	`\rightarrow`	→
`\kappa`	κ	`\Upsilon`	ϒ	`\Rightarrow`	⇒
`\lambda`	λ	`\Phi`	Φ	`\downarrow`	↓
`\mu`	µ	`\Psi`	Ψ	`\circ`	º
`\nu`	ν	`\Omega`	Ω	`\pm`	±
`\xi`	ξ	`\forall`	∀	`\geq`	≥
`\pi`	π	`\exists`	∃	`\propto`	∝
`\rho`	ρ	`\ni`	∍	`\partial`	∂
`\sigma`	σ	`\cong`	≅	`\bullet`	•
`\varsigma`	ς	`\approx`	≈	`\div`	÷
`\tau`	τ	`\Re`	ℜ	`\neq`	≠
`\equiv`	≡	`\oplus`	⊕	`\aleph`	ℵ
`\Im`	ℑ	`\cup`	∪	`\wp`	℘
`\otimes`	⊗	`\subseteq`	⊆	`\oslash`	∅
`\cap`	∩	`\in`	∈	`\supseteq`	⊇
`\supset`	⊃	`\lceil`	⌈	`\subset`	⊂
`\int`	∫	`\cdot`	·	`\o`	ο
`\rfloor`	⌋	`\neg`	¬	`\nabla`	∇
`\lfloor`	⌊	`\times`	x	`\ldots`	...
`\perp`	⊥	`\surd`	√	`\prime`	´
`\wedge`	∧	`\varpi`	ϖ	\0	∅
`\rceil`	⌉	`\rangle`	〉	`\mid`	\|
`\vee`	∨	`\langle`	〈	`\copyright`	©

Выходные аргументы

свернуть все

Объект `f` — `Figure`
Объект `Figure`

Объект Figure для диалогового окна. Используйте f, чтобы запросить и изменить свойства диалогового окна.

Больше о

свернуть все

модальное диалоговое окно

Модальное диалоговое окно препятствует тому, чтобы пользователь взаимодействовал с другими окнами прежде, чем ответить на модальное диалоговое окно.

Советы

Выполнение программы продолжается, даже когда модальное диалоговое окно активно. Чтобы блокировать выполнение программы MATLAB, пока пользователь не ответит на модальное диалоговое окно, используйте функцию uiwait.
Модальные диалоговые окна (созданное использование errordlg, msgbox или warndlg) заменяют любые существующие диалоговые окна, созданные на эти функции, которые также имеют то же имя.

Смотрите также

errordlg | helpdlg | warndlg

Документация

msgbox

Синтаксис

Описание

Примеры

Простое диалоговое окно сообщения

Обмен сообщениями текста диалогового окна с разрывами строки

Обмен сообщениями диалогового окна с заголовком

Диалоговое окно Message, которое использует встроенный значок

Передайте диалоговое окно, которое использует пользовательский значок истинного цвета

Передайте диалоговое окно, которое использует значок индексированного цвета

Модальное диалоговое окно сообщения

Модальное диалоговое окно сообщения, которое использует форматированное сообщение TeX

Входные параметры

`сообщение` Текст диалогового окна
вектор символов | массив ячеек из символьных векторов | массив строк

`заголовок` Заголовок
вектор символов | представляет скаляр в виде строки

`значок` Значок
`'none'` (значение по умолчанию) | `'help'` | `'warn'` | `'error'` | `'custom'`

`iconData` Матрица изображений
массив m на n | m n 3 матрицами изображений истинного цвета

`iconCMap` Палитра
матрица с тремя столбцами триплетов RGB

Режим `createmode` — Window
`'non-modal'` (значение по умолчанию) | `'modal'` | `'replace'` | массив структур

TeX Markup

Выходные аргументы

Объект `f` — `Figure`
Объект `Figure`

Больше о

модальное диалоговое окно

Советы

Смотрите также

Представлено до R2006a

Документация MATLAB

Поддержка

Документация

msgbox

Синтаксис

Описание

Примеры

Простое диалоговое окно сообщения

Обмен сообщениями текста диалогового окна с разрывами строки

Обмен сообщениями диалогового окна с заголовком

Диалоговое окно Message, которое использует встроенный значок

Передайте диалоговое окно, которое использует пользовательский значок истинного цвета

Передайте диалоговое окно, которое использует значок индексированного цвета

Модальное диалоговое окно сообщения

Модальное диалоговое окно сообщения, которое использует форматированное сообщение TeX

Входные параметры

сообщение Текст диалогового окна вектор символов | массив ячеек из символьных векторов | массив строк

заголовок Заголовок вектор символов | представляет скаляр в виде строки

значок Значок 'none' (значение по умолчанию) | 'help' | 'warn' | 'error' | 'custom'

iconData Матрица изображений массив m на n | m n 3 матрицами изображений истинного цвета

iconCMap Палитра матрица с тремя столбцами триплетов RGB

Режим createmode — Window 'non-modal' (значение по умолчанию) | 'modal' | 'replace' | массив структур

TeX Markup

Выходные аргументы

Объект f — Figure Объект Figure

Больше о

модальное диалоговое окно

Советы

Смотрите также

Представлено до R2006a

Документация MATLAB

Поддержка

`сообщение` Текст диалогового окна
вектор символов | массив ячеек из символьных векторов | массив строк

`заголовок` Заголовок
вектор символов | представляет скаляр в виде строки

`значок` Значок
`'none'` (значение по умолчанию) | `'help'` | `'warn'` | `'error'` | `'custom'`

`iconData` Матрица изображений
массив m на n | m n 3 матрицами изображений истинного цвета

`iconCMap` Палитра
матрица с тремя столбцами триплетов RGB

Режим `createmode` — Window
`'non-modal'` (значение по умолчанию) | `'modal'` | `'replace'` | массив структур

Объект `f` — `Figure`
Объект `Figure`