ProgressDialog Properties

Управляйте внешним видом и поведением диалогового окна прогресса

Диалоговые окна прогресса указывают, что операция происходит путем отображения анимированного индикатора выполнения. uiprogressdlg функция создает диалоговое окно прогресса и устанавливает любые необходимые свойства прежде, чем отобразить его. Путем изменения значений свойств диалогового окна прогресса можно изменить определенные аспекты его внешнего вида и поведения. Используйте запись через точку, чтобы относиться к конкретному объекту и свойству:

fig = uifigure;
d = uiprogressdlg(fig);
d.Value = .25;

Текст и моделирование

развернуть все

`Message` сообщение
`''` (значение по умолчанию) | вектор символов | массив ячеек из символьных векторов | массив строк

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

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

Пример: d = uiprogressdlg(uifigure,'Message','Calculating result.');

`Title` заголовок
`''` (значение по умолчанию) | вектор символов | строковый скаляр

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

Пример: d = uiprogressdlg(uifigure,'Title','Calculating');

`Icon` Значок
`''` (значение по умолчанию) | предопределенный значок | пользовательский значок

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

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

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

Значение	Значок
`''` (значение по умолчанию)	Никакие отображения значка.
`'question'`
`'info'`
`'success'`
`'warning'`
`'error'`

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

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

Вектор символов или строковый скаляр, который задает имя файла SVG, JPEG, GIF или изображения PNG, которое находится на MATLAB^® path. В качестве альтернативы можно задать полный путь к файлу изображения.
Матрица изображений истинного цвета. Смотрите Типы изображения для получения дополнительной информации.

`Interpreter` — Диалоговый текстовый интерпретатор
`'none'` (значение по умолчанию) | `'tex'` | `'latex'` | `'html'`

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

'none' — Отобразите буквенные символы.
'tex'— Интерпретируйте текст с помощью подмножества разметки TeX.
'latex'— Интерпретируйте текст с помощью подмножества разметки LATEX.
'html'— Интерпретируйте текст с помощью подмножества разметки HTML.

TeX Markup

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

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете интерпретатор на '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Пурпурный`, `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	Атрибуты	Описание
`a`	`style`, `target`, `hrefзаголовок`	Гиперссылка
`abbr`	`styleзаголовок`	Сокращение или акроним
`address`	`style`	Контактная информация
`article`	`style`	Автономное, независимое содержимое
`aside`	`style`	Содержимое косвенно связано с основным содержанием
`b`	`style`	Полужирный текст
`bdi`	`styledir`	Содержимое отформатировано в различном направлении из сопроводительного текста
`bdo`	`styledir`	Содержимое отформатировано в различном направлении из сопроводительного текста
`big`	`style`	Текст один уровень размера шрифта, больше, чем сопроводительный текст (устаревший в HTML5)
`blockquote`	`style`, `cite`	Расширенная цитата
`br`	n/A	Разрыв строки
`caption`	`style`	Заголовок или заголовок таблицы
`center`	`style`	Содержимое сосредоточено горизонтально
`cite`	`style`	Заголовок творческой работы
`code`	`style`	Фрагмент кода
`col`	`styleвыравнивание`, `valign`, `spanwidth`	Столбец в рамках таблицы
`colgroup`	`styleвыравнивание`, `valign`, `spanwidth`	Группа столбцов в рамках таблицы
`dd`	`style`	Термин или значение в списке описаний
`del`	`styledatetime`	Текст, который был удален из документа
`details`	`styleоткрытый`	Интерактивный виджет с текстом, видимым только, когда переключено, чтобы 'открыть' состояние
`dl`	`style`	Список описаний
`dt`	`style`	Термин или значение в списке описаний
`em`	`style`	Подчеркнутый текст (обычно отображенный в курсиве)
`font`	`style`, `colorразмер`, `face`	Текст с заданными свойствами шрифта (устаревший в HTML5)
`footer`	`style`	Нижний колонтитул
`h1`. `h2`, `h3`, `h4`, `h5`, `h6`	`style`	Заголовок раздела — `<h1>` высший уровень заголовка и `<h6>` является самым низким
`header`	`style`	Вводное содержимое
`hr`	`style`	Тематический пропуск
`i`	`style`	Текстовое смещение от окружающего содержимого — по умолчанию представленный как курсив
`ins`	`styledatetime`	Текст вставляется в документ
`li`	`style`	Элемент в списке
`mark`	`style`	Отмеченный или выделенный текст
`ol`	`style`	Упорядоченный список
`p`	`style`	Абзац
`pre`	`style`	Предварительно отформатированный текст
`s`	`style`	Текст с перечеркиванием
`strike`	`style`	Текст с перечеркиванием (устаревший в HTML5)
`section`	`style`	Автономный раздел
`small`	`style`	Текст один уровень размера шрифта, меньший, чем сопроводительный текст (устаревший в HTML5)
`sub`	`style`	Индекс
`sup`	`style`	Верхний индекс
`strong`	`style`	Текст с сильной важностью
`table`	`stylewidth'Граница'` `выравнивание`, `valign`	Таблица
`tbody`	`styleвыравнивание`, `valign`	Табличное тело
`td`	`stylewidth`, `rowspan`, `colspanвыравнивание`, `valign`	Ячейка данных таблицы
`tfoot`	`styleвыравнивание`, `valign`	Набор строк таблицы, которые обобщают столбцы таблицы
`th`	`stylewidth`, `rowspan`, `colspanвыравнивание`, `valign`	Ячейка данных таблицы, заданная как заголовок группы ячеек
`thead`	`styleвыравнивание`, `valign`	Набор строк таблицы, которые задают заголовки столбцов
`tr`	`style`, `rowspanвыравнивание`, `valign`	Строка ячеек таблицы
`tt`	`style`	Моноширинный текст (устаревший в HTML5)
`u`	`style`	Текст с невнятной аннотацией — по умолчанию представленный как подчеркивание
`ul`	`style`	Неупорядоченный список

Для получения дополнительной информации об этих элементах, см. 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.

Прогресс

развернуть все

`Value` — Завершенная часть
0 (значение по умолчанию) | номер между `0` и `1`

Часть, завершенная в виде номера между 0 и 1. Индикатор выполнения достигает своего полного, когда значением является 1. Измените Value в различных точках в вашем коде, чтобы обеспечить визуальную индикацию относительно прогресса запущенного приложения.

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

`ShowPercentage` — Покажите процент
`'off'` (значение по умолчанию) | логическое значение включения - выключения

Покажите процент в виде 'off' или 'on', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Установите это свойство на 'on' чтобы отобразить часть завершаются как процент в диалоговом окне.

`Indeterminate` — Неопределенный прогресс
`'off'` (значение по умолчанию) | логическое значение включения - выключения

Неопределенный прогресс в виде 'off' или 'on', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Установите это свойство на 'on' обеспечить анимированную панель без любой определенной информации о прогрессе. Эта анимация полезна, когда вы не знаете, сколько времени вычисление возьмет.

Чтобы препятствовать тому, чтобы неопределенные индикаторы выполнения отобразились неопределенно, вызовите close функция после завершения ваших вычислений.

Интерактивность

развернуть все

`Cancelable` — Позвольте отмену
`'off'` (значение по умолчанию) | логическое значение включения - выключения

Позвольте отмену в виде 'off' или 'on', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

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

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

`CancelText` — Текст кнопки отмены
`'Cancel'` (значение по умолчанию) | вектор символов | строковый скаляр

Текст кнопки отмены в виде вектора символов или строкового скаляра. Это свойство оказывает влияние только когда Cancelable свойство установлено в 'on'.

Пример: d = uiprogressdlg(uifigure,'Cancelable','on','CancelText','Stop')

`CancelRequested` — Отмену требуют
`true` | `false`

Отмену требуют в виде true или false. Используйте это свойство когда Cancelable 'on', и вы хотите знать, кликнул ли пользователь по кнопке отмены. Этим свойством является false пока пользователь не кликает по кнопке отмены, затем значение превращается в true.

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

uiprogressdlg | appdesigner

Введенный в R2018a

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

ProgressDialog Properties

Текст и моделирование

`Message` сообщение
`''` (значение по умолчанию) | вектор символов | массив ячеек из символьных векторов | массив строк

`Title` заголовок
`''` (значение по умолчанию) | вектор символов | строковый скаляр