Exponenta Banner
exponenta event banner

Свойства ProgressDialog

Внешний вид и поведение диалогового окна «Ход выполнения управления»

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

В диалоговых окнах хода выполнения операции отображается анимированный индикатор хода выполнения. 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

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

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

Для предотвращения бесконечного отображения неопределенных индикаторов выполнения вызовите close после завершения вычислений.

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

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

Разрешить отмену, указано как 'off' или 'on'или как числовое или логическое 1 (true) или 0 (false). Значение '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

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

Поддержка