Свойства ProgressDialog

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

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

uf = uifigure;
d = uiprogressdlg(uf);
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®. Также можно задать полный путь к файлу изображения.

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

Прогресс

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|

Введенный в R2018a

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