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®. В качестве альтернативы можно задать полный путь к файлу изображения.

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

Прогресс

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|

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