exponenta event banner

msgbox

Диалоговое окно «Создание сообщения»

Описание

пример

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');

Считывание изображения 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'));

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

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

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

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

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

свернуть все

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

Пример: 'Operation Completed'

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

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

Пример: 'Success'

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

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

СтоимостьСимвол
'help'

'warn'

'error'

'none'Значок не отображается.

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

Режим окна, указанный как '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'
\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'

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

©

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

свернуть все

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

Подробнее

свернуть все

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

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

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

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

Совет

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

  • Выполнение программы продолжается даже при активном модальном диалоговом окне. Чтобы заблокировать выполнение программы MATLAB до тех пор, пока пользователь не ответит на модальное диалоговое окно, используйте uiwait функция.

  • Создание модального диалогового окна оповещения для одного окна App Designer или uifigure- приложения на основе, используйте uialert вместо этого функция.

См. также

| | |

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