msgbox

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

Свернуть все на странице

Синтаксис

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 для соответствия рисунка соответствующего размера.

Используйте эту функцию, если вы хотите показать диалоговое окно сообщения в нескольких окнах приложения, MATLAB^® рабочий стол, или Simulink^® и по-прежнему иметь возможность взаимодействовать с ними перед ответом на диалоговое окно.

пример

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

пример

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

пример

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

пример

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

Примеры

свернуть все

Диалоговое окно простого сообщения

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

f = msgbox('Operation Completed');

Текст диалогового окна сообщения с Линией Пропусков

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

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

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

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

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

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

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

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

Диалоговое окно сообщения, в котором используется пользовательский значок Truecolor

Чтение изображения 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

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

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

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

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

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

свернуть все

`message` - Текст диалогового окна
вектор символов | массив ячеек из векторов символов | строковые массивы

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

Пример: 'Operation Completed'

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

`title` - Заголовок
вектор символов | строковый скаляр

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

Пример: 'Success'

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

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

В этой таблице перечислены значения и соответствующие значки.

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

`icondata` - Массив изображений
m-на-n массив | m-на-n-на-3 truecolor массив изображений

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

`iconcmap` - Палитра
трехколоночная матрица триплетов RGB

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

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

`createmode` - Оконный режим
`'non-modal'` (по умолчанию) | `'modal'` | `'replace'` | массив структур

Оконный режим, заданный как '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 значение как TeX. Значение по умолчанию для Interpreter является 'none'.

Синтаксис TeX

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

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

Модификатор	Описание	Пример
`^{ }`	Верхний индекс	`'text^{superscript}'`
`_{ }`	Индекс	`'text_{subscript}'`
`\bf`	Полужирный шрифт	`'\bf text'`
`\it`	Италический шрифт	`'\it text'`
`\sl`	Косой шрифт (обычно тот же, что и курсивный шрифт)	`'\sl text'`
`\rm`	Обычный шрифт	`'\rm text'`
`\ fontname {specifier}`	Название шрифта - Заменить `specifier` с именем семейства шрифтов. Это можно использовать в сочетании с другими модификаторами.	`'\fontname{Courier} text'`
`\ fontsize {specifier}`	Размер шрифта - Заменить `specifier` с числовым скаляром значением в модули точек.	`'\fontsize{15} text'`
`\ цвет {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'`

В этой таблице перечислены поддерживаемые специальные символы для '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 запрос и изменение свойств диалогового окна.

Подробнее о

свернуть все

Диалоговое окно Modal

Модальное диалоговое окно препятствует взаимодействию пользователя с другими окнами MATLAB перед ответом на диалоговое окно.

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

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

Совет

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

См. также

errordlg | helpdlg | uialert | warndlg

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

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

msgbox

Синтаксис

Описание

Примеры

Диалоговое окно простого сообщения

Текст диалогового окна сообщения с Линией Пропусков

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

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

Диалоговое окно сообщения, в котором используется пользовательский значок Truecolor

Диалоговое окно сообщения, в котором используется значок индексированного цвета

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

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

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

`message` - Текст диалогового окна
вектор символов | массив ячеек из векторов символов | строковые массивы

`title` - Заголовок
вектор символов | строковый скаляр

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

`icondata` - Массив изображений
m-на-n массив | m-на-n-на-3 truecolor массив изображений

`iconcmap` - Палитра
трехколоночная матрица триплетов RGB

`createmode` - Оконный режим
`'non-modal'` (по умолчанию) | `'modal'` | `'replace'` | массив структур

Синтаксис TeX

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

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

Подробнее о

Диалоговое окно Modal

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

Совет

См. также

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

Поддержка

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

msgbox

Синтаксис

Описание

Примеры

Диалоговое окно простого сообщения

Текст диалогового окна сообщения с Линией Пропусков

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

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

Диалоговое окно сообщения, в котором используется пользовательский значок Truecolor

Диалоговое окно сообщения, в котором используется значок индексированного цвета

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

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

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

message - Текст диалогового окна вектор символов | массив ячеек из векторов символов | строковые массивы

title - Заголовок вектор символов | строковый скаляр

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

icondata - Массив изображений m-на-n массив | m-на-n-на-3 truecolor массив изображений

iconcmap - Палитра трехколоночная матрица триплетов RGB

createmode - Оконный режим 'non-modal' (по умолчанию) | 'modal' | 'replace' | массив структур

Синтаксис TeX

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

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

Подробнее о

Диалоговое окно Modal

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

Совет

См. также

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

Поддержка

`message` - Текст диалогового окна
вектор символов | массив ячеек из векторов символов | строковые массивы

`title` - Заголовок
вектор символов | строковый скаляр

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

`icondata` - Массив изображений
m-на-n массив | m-на-n-на-3 truecolor массив изображений

`iconcmap` - Палитра
трехколоночная матрица триплетов RGB

`createmode` - Оконный режим
`'non-modal'` (по умолчанию) | `'modal'` | `'replace'` | массив структур

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