ProgressDialog Properties

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

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

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

Текст и стилизация

расширить все

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

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

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

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

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

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

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

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

ЗначениеЗначок
'' (по умолчанию)Значок не отображается.
'question'

'info'

'success'

'warning'

'error'

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

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

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

  • Массив изображений truecolor. Дополнительные сведения см. в разделе Типы изображений.

Прогресс

расширить все

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

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

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

Установите это свойство на 'on' отображение дроби в виде процента в диалоговом окне.

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

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

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

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

расширить все

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

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

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

Отмена текста кнопки в виде вектора символов или строкового скаляра. Это свойство имеет эффект только, когда Cancelable для свойства задано значение 'on'.

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

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

См. также

|

Введенный в R2018a
Для просмотра документации необходимо авторизоваться на сайте