uialert

Отобразите аварийное диалоговое окно

Описание

пример

uialert(fig,message,title) отображает модальное диалоговое окно перед заданным окном рисунка. Фигура должна быть создана с uifigure функция. Диалоговое окно отображается заданное сообщение и имеет строку заголовка с заданным заголовком. По умолчанию диалоговое окно также содержит значок ошибки и кнопку OK.

пример

uialert(___,Name,Value) отображает диалоговое окно со свойствами, заданными одним или несколькими Name,Value аргументы.

Примеры

свернуть все

Создайте модальное аварийное диалоговое окно. Фигура позади него недоступна, пока вы не закрываете диалоговое окно.

fig = uifigure;
uialert(fig,'File not found','Invalid File');

Alert dialog box. The icon is a red octagon with an exclamation point. The title of the dialog box is "Invalid File" and the text is "File not found". The box has an OK button in the bottom right.

fig = uifigure;
message = {'Fire hazard!','Consider reducing temperature.'};
uialert(fig,message,'Warning',...
'Icon','warning');

Warning dialog box. The text spans two lines. The first line says "Fire hazard!" and the second line says "Consider reducing temperature".

Создайте фигуру и две матрицы различных размеров.

fig = uifigure; 
A = rand(3);
B = ones(5);

Попытайтесь вертикально конкатенировать матрицы. Обработайте любые ошибки, которые происходят путем получения текста ошибки и создания аварийного диалогового окна на рисунке, и затем задают текст ошибки как диалоговое сообщение. MATLAB® текст ошибки часто включает форматирование HTML, поэтому задайте диалоговый интерпретатор как 'html'. Ошибка отображена со ссылкой на документацию для vertcat функция.

try 
    C = vertcat(A,B);
catch ME 
    report = getReport(ME);
    uialert(fig,report,'Error Message','Interpreter','html');
end

Alert dialog box. The message says: "Error using vertcat. Dimensions of arrays being concatenated are not consistent". The word "vertcat" is a blue hyperlink.

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

свернуть все

Плановый показатель в виде Figure объект. Фигура должна быть создана с uifigure функция.

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

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

Пример: 'Invalid value'

Заголовок в виде вектора символов или строкового скаляра. Длинные заголовки обрезают и сопровождаются замещающими знаками. Точная длина, в которой заголовок является усеченным, зависит от вашей системной настройки.

Пробелы заменяют символы формата, такие как новая строка (\nСимвол.

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Icon','warning'

Аварийное диалоговое окно близко запрашивает функцию обратного вызова в виде одного из этих значений:

  • Указатель на функцию.

  • Массив ячеек, в котором первым элементом является указатель на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, который является допустимым выражением MATLAB. MATLAB оценивает это выражение в базовом рабочем пространстве.

CloseFcn коллбэк выполняется, когда пользователь приложения отклоняет аварийное диалоговое окно путем нажатия близкой кнопки в строке заголовка или нажатия кнопки OK. CloseFcn функция также выполняется, когда пользователь приложения закрывает окно рисунка, для которого аварийное диалоговое окно отображается из командной строки MATLAB. Можно закрыть окно рисунка из командной строки с помощью close функция.

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

Предопределенный значок

Эта таблица приводит значения для предопределенных значков. Например, чтобы показать значок галочки, задайте пару "имя-значение" 'Icon','success'.

ЗначениеЗначок
'error' (значение по умолчанию)

Red octagon with an exclamation point symbol.

'warning'

Yellow triangle with an exclamation point symbol.

'info'

Blue square with the letter "i".

'success'

Green circle with a check mark symbol.

''

Никакие отображения значка.

Пользовательский значок

Задайте пользовательский значок как одно из этих значений:

  • Вектор символов, который задает имя файла SVG, JPEG, GIF или изображения PNG, которое находится на пути MATLAB. В качестве альтернативы можно задать полный путь к файлу изображения.

  • Матрица изображений истинного цвета. Смотрите Типы изображения для получения дополнительной информации.

Модальный в виде true или false.

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

Диалоговый текстовый интерпретатор в виде:

  • 'none' — Отобразите буквенные символы.

  • 'tex'— Интерпретируйте текст с помощью подмножества разметки TeX.

  • 'latex'— Интерпретируйте текст с помощью подмножества разметки LATEX.

  • 'html'— Интерпретируйте текст с помощью подмножества разметки HTML.

TeX Markup

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

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

МодификаторОписаниеПример
^{ }Верхний индекс'text^{superscript}'
_{ }Индекс'text_{subscript}'
\bfBold 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Пурпурный, blue, black, whiteсерый, 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

©

Разметка LaTeX

Используйте разметку LATEX, чтобы отформатировать и отобразить математические выражения, уравнения и специальные символы. Используйте долларовые символы вокруг повышенного текста. Например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

Отображаемый текст использует стиль шрифта LaTeX по умолчанию. Можно использовать разметку LATEX, чтобы изменить стиль шрифта.

MATLAB поддерживает большинство стандартных математических команд режима LaTeX. Для получения дополнительной информации смотрите Поддерживаемые Команды LaTeX.

Разметка HTML

Используйте разметку HTML, чтобы отобразить ссылки и настроить стили шрифта.

Интерпретатор поддерживает подмножество разметки HTML. Как общее руководство, интерпретатор поддерживает связанные с текстом теги и стили. Неподдерживаемые теги и стили проигнорированы.

Эта таблица приводит поддерживаемые элементы и атрибуты элемента.

Элемент HTMLАтрибутыОписание
astyle, target, hrefзаголовокГиперссылка
abbrstyleзаголовокСокращение или акроним
addressstyleКонтактная информация
articlestyleАвтономное, независимое содержимое
asidestyleСодержимое косвенно связано с основным содержанием
bstyleПолужирный текст
bdistyledirСодержимое отформатировано в различном направлении из сопроводительного текста
bdostyledirСодержимое отформатировано в различном направлении из сопроводительного текста
bigstyleТекст один уровень размера шрифта, больше, чем сопроводительный текст (устаревший в HTML5)
blockquotestyle, citeРасширенная цитата
brn/AРазрыв строки
captionstyleЗаголовок или заголовок таблицы
centerstyleСодержимое сосредоточено горизонтально
citestyleЗаголовок творческой работы
codestyleФрагмент кода
colstyleвыравнивание, valign, spanwidthСтолбец в рамках таблицы
colgroupstyleвыравнивание, valign, spanwidthГруппа столбцов в рамках таблицы
ddstyleТермин или значение в списке описаний
delstyledatetimeТекст, который был удален из документа
detailsstyleоткрытыйИнтерактивный виджет с текстом, видимым только, когда переключено, чтобы 'открыть' состояние
dlstyleСписок описаний
dtstyleТермин или значение в списке описаний
emstyleПодчеркнутый текст (обычно отображенный в курсиве)
fontstyle, colorразмер, faceТекст с заданными свойствами шрифта (устаревший в HTML5)
footerstyleНижний колонтитул
h1. h2, h3, h4, h5, h6styleЗаголовок раздела — <h1> высший уровень заголовка и <h6> является самым низким
headerstyleВводное содержимое
hrstyleТематический пропуск
istyleТекстовое смещение от окружающего содержимого — по умолчанию представленный как курсив
insstyledatetimeТекст вставляется в документ
listyleЭлемент в списке
markstyleОтмеченный или выделенный текст
olstyleУпорядоченный список
pstyleАбзац
prestyleПредварительно отформатированный текст
sstyleТекст с перечеркиванием
strikestyleТекст с перечеркиванием (устаревший в HTML5)
sectionstyleАвтономный раздел
smallstyleТекст один уровень размера шрифта, меньший, чем сопроводительный текст (устаревший в HTML5)
substyleИндекс
supstyleВерхний индекс
strongstyleТекст с сильной важностью
tablestylewidth'Граница' выравнивание, valignТаблица
tbodystyleвыравнивание, valignТабличное тело
tdstylewidth, rowspan, colspanвыравнивание, valignЯчейка данных таблицы
tfootstyleвыравнивание, valignНабор строк таблицы, которые обобщают столбцы таблицы
thstylewidth, rowspan, colspanвыравнивание, valignЯчейка данных таблицы, заданная как заголовок группы ячеек
theadstyleвыравнивание, valignНабор строк таблицы, которые задают заголовки столбцов
trstyle, rowspanвыравнивание, valignСтрока ячеек таблицы
ttstyleМоноширинный текст (устаревший в HTML5)
ustyleТекст с невнятной аннотацией — по умолчанию представленный как подчеркивание
ulstyleНеупорядоченный список

Для получения дополнительной информации об этих элементах, см. https://developer.mozilla.org/en-US/docs/Web/HTML/Element.

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

Эти атрибуты CSS поддерживаются:

  • background-color

  • border-bottom

  • border-bottom-color

  • border-bottom-left-radius

  • border-bottom-right-radius

  • border-bottom-style

  • border-bottom-width

  • border-left

  • border-left-color

  • border-left-style

  • border-left-width

  • border-radius

  • border-right

  • border-right-color

  • border-right-style

  • border-right-width

  • border-spacing

  • border-style

  • border-top

  • border-top-color

  • border-top-left-radius

  • border-top-right-radius

  • border-top-style

  • border-top-width

  • border-width

  • color

  • direction

  • font-family

  • font-size

  • font-style

  • font-weight

  • height

  • hidden

  • line-height

  • margin

  • margin-bottom

  • margin-left

  • margin-right

  • margin-top

  • max-height

  • max-width

  • min-height

  • min-width

  • overflow

  • overflow-wrap

  • overflow-x

  • overflow-y

  • padding

  • padding-bottom

  • padding-left

  • padding-right

  • padding-top

  • text-align

  • text-anchor

  • text-decoration

  • text-indent

  • text-overflow

  • text-shadow

  • text-transform

  • title

  • translate

  • white-space

  • width

Для получения дополнительной информации об этих атрибутах, см. https://developer.mozilla.org/en-US/docs/Web/CSS/Reference.

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

Функции

Введенный в R2016a