uiconfirm

Создайте поле диалогового окна подтверждения

Описание

uiconfirm(fig,message,title) отображается модальное диалоговое окно подтверждения в приложении окружают заданный плановый показатель. Плановый показатель должен быть создан с uifigure функция. Этот синтаксис отображает две опции для пользователя, чтобы выбрать, OK и Cancel. Вы не можете получить доступ к фигуре позади диалогового окна, в то время как диалоговое окно открыто, но можно получить доступ к MATLAB® командная строка.

пример

uiconfirm(fig,message,title,Name,Value) отображает поле диалогового окна подтверждения с одним или несколькими Name,Value аргументы, которые настраивают внешний вид и поведение диалогового окна. Например, можно задать пользовательский набор опций в диалоговом окне вместо значения по умолчанию, OK и Cancel.

пример

selection = uiconfirm(___) возвращает пользовательский выбор как вектор символов. Задайте selection выходной аргумент с любым из предыдущих синтаксисов. Когда вы используете этот синтаксис, вы не можете получить доступ к командной строке MATLAB, в то время как диалоговое окно открыто.

Примеры

свернуть все

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

fig = uifigure;
selection = uiconfirm(fig,'Close document?','Confirm Close',...
                        'Icon','warning');

Figure window with a confirmation dialog box. The dialog has a yellow warning icon.

Когда пользователь выбирает опцию, uiconfirm возвращает тот выбор как вектор символов.

Создайте диалоговое окно подтверждения, содержащее три опции: Overwrite, Save as new и Cancel. Задайте Save as new как опцию по умолчанию и задайте Cancel как опцию, которая сопоставляет с поведением отмены.

fig = uifigure;
msg = 'Saving these changes will overwrite previous changes.';
title = 'Confirm Save';
selection = uiconfirm(fig,msg,title, ...
           'Options',{'Overwrite','Save as new','Cancel'}, ...
           'DefaultOption',2,'CancelOption',3);

Figure window with a confirmation dialog box asking the user to confirm their save. There are three options. The second option, "Save as new", is highlighted in blue.

Когда пользователь выбирает опцию, uiconfirm возвращает их выбор как вектор символов.

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

fig = uifigure;
ax = polaraxes(fig);
msg = 'Do you want to plot $$r = \exp \left(\frac{\theta}{10}\right)?$$';
selection = uiconfirm(fig,msg,'Plot equation','Interpreter','latex');
switch selection
    case 'OK'
        theta = -100:0.1:0;
        r = exp(theta/10);
        polarplot(ax,theta,r);
    case 'Cancel'
        return
end

Figure window with a polar axes and a dialog box asking if you want to plot a polar equation.

Нажмите OK, чтобы построить уравнение.

Figure window with a spiral curve plotted on a polar axes.

CloseFcn аргумент значения имени полезен для выполнения определенных задач, когда диалоговое окно закрывается.

В редакторе MATLAB создайте скрипт, который содержит следующий код. Код создает фигуру и задает две функции обратного вызова под названием figcallback и dlgcallback.

  • figcallback функция выполняется, когда пользователь пытается закрыть окно рисунка. Функция создает диалоговое окно подтверждения, окружают окно рисунка, и задает dlgcallback функционируйте как диалоговое окно CloseFcn 'callback'.

  • dlgcallback функция выполняется, когда диалоговое окно закрывается. Функциональные доступы SelectedOption поле в struct названный event, который MATLAB передает в качестве второго аргумента функции обратного вызова. Если пользователь выбирает OK, функция закрывает окно рисунка.

fig = uifigure('CloseRequestFcn',@figcallback);

function figcallback(src,event)
    uiconfirm(src,'Close app?','Confirm Close', ...
        'CloseFcn',@dlgcallback);
end

function dlgcallback(src,event)
    if event.SelectedOption == "OK"
        delete(event.Source)
    end
end

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

Figure window with a confirmation dialog box that says "Close app?"

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

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

Запишите CloseFcn коллбэк для поля диалогового окна подтверждения, которое закрывает окно рисунка приложения, если пользователь выбирает OK. Во-первых, в App Designer Code View, создайте закрытую функцию путем выбора Function> Private Function. Затем запишите закрытую функцию так, чтобы она совпадала с этим кодом:

function mycallback(app,src,event)
    if event.SelectedOption == "OK"
        delete(app.UIFigure);
    end
end

Наконец, чтобы отобразить диалоговое окно, когда пользователь попытается закрыть приложение, создайте CloseRequestFcn коллбэк для окна рисунка. Нажмите Callback и выберите app.UIFigure как компонент и CloseRequestFcn как коллбэк, и затем нажимают Add Callback. Замените тело функции обратного вызова, которую App Designer создает с этим кодом:

uiconfirm(app.UIFigure,'Close document?','Confirm Close', ...
            'CloseFcn',@app.mycallback);

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

Figure window with a confirmation dialog box that says "Close app?"

Для получения дополнительной информации о программно создании компонентов и определении функций обратного вызова, смотрите, Добавляют Компоненты пользовательского интерфейса к App Designer Программно.

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

свернуть все

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

Обменивайтесь сообщениями, чтобы отобразиться в виде вектора символов, массива ячеек из символьных векторов или массива строк. Задайте массив ячеек или массив строк, когда ваше сообщение будет иметь несколько линий текста. Каждый элемент в массиве соответствует различной линии текста.

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

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

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

Пример: selection = uiconfirm(fig,message,title,'Options',{'Save','Delete','Quit'}) задает три пользовательских опции для диалогового окна.

Пользовательские опции в виде массива ячеек из символьных векторов или массива строк.

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

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

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

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

Blue circle with a question mark symbol.

'info'

Blue square with the letter "i".

'success'

Green circle with a check mark symbol.

'warning'

Yellow triangle with an exclamation point symbol.

'error'

Red octagon with an exclamation point symbol.

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

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

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

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

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

Опция по умолчанию в виде вектора символов, строкового скаляра или целого числа. Опция по умолчанию соответствует кнопке в диалоговом окне, которое фокусируется по умолчанию.

Когда вы задаете вектор символов или строковый скаляр, это должно совпадать с элементом в Options массив. Однако, если вы вызываете uiconfirm без Options аргумент, затем DefaultOption должен быть 'OK' или 'Cancel'.

Когда вы задаете целое число, это должно быть в области значений [1, n], где n является длиной Options массив. Если вы вызываете uiconfirm без Options аргумент, затем DefaultOption должен быть 1 или 2.

Отмените опцию в виде вектора символов, строкового скаляра или целого числа. Опция отмены задает который карты опции отменить действия в диалоговом окне.

Когда вы задаете вектор символов или строковый скаляр, это должно совпадать с элементом в Options массив. Однако, если вы вызываете uiconfirm без Options аргумент, затем CancelOption должен быть 'OK' или 'Cancel'.

Когда вы задаете целое число, это должно быть в области значений [1, n], где n является длиной Options массив. Если вы вызываете uiconfirm без Options аргумент, затем CancelOption должен быть 1 или 2.

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

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

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

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

Этот коллбэк полезен для выполнения определенных задач, когда диалоговое окно закрывается.

Когда вы задаете CloseFcn как указатель на функцию (или массив ячеек, содержащий указатель на функцию), MATLAB передает struct содержа данные о событиях как входной параметр к функции обратного вызова. Этот struct содержит поля, описанные в следующей таблице.

Поле структурыЗначение
SourceFigure объект сопоставлен с диалоговым окном.
EventName'ConfirmDialogClosed'
DialogTitleЗаголовок диалогового окна.
SelectedOptionIndexИндекс выбранной опции. Для n опции, индекс может быть любым целым числом от 1 к n.
SelectedOptionНазвание кнопки для выбранной опции, возвращенной как вектор символов.

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

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

  • '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.

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

| | |

Введенный в R2017b