Индикатор прогресса

Элемент управления, визуально отображающий степень выполнения (прогресс) какого-то процесса (задачи). Анимация производится с помощью прямоугольника, вначале отображающегося пустым, и постепенно (по мере того, как процесс близится к завершению) закрашивающимся пропорционально тому, какой процент задачи выполнен к данному моменту времени. При необходимости в поле элемента управления можно также отображать численное значение процента выполненной задачи.

Чтобы показать, что выполняется задача неопределенной длительности, Вы можете использовать нефиксированный режим строки прогресса. В этом режиме строка прогресса будет просто отображать анимацию того, что процесс выполняется. Как только Вы сможете оценить длительность задачи и текущий прогресс ее выполнения, нужно будет обновить значение строки прогресса и переключить ее в Фиксированный режим.

 Чтобы добавить индикатор прогресса
  1. Перетащите элемент Индикатор прогресса  из палитры Элементы управления в то место графического редактора, где Вы хотите его нарисовать.
Основные свойства

Имя – Имя индикатора прогресса. Имя используется для идентификации элемента и доступа к нему из кода.

Отображать имя – Если опция выбрана, то имя индикатора прогресса будет отображаться в графическом редакторе.

Исключить – Если опция выбрана, то индикатор прогресса будет исключена из модели.

На верхнем уровне – Если опция выбрана, то индикатор прогресса будет виден на презентации класса, в который будет вложен данный активный объект.

Значок – Если опция выбрана, то индикатор прогресса будет считаться частью значка класса активного объекта.

Ориентация – Задает ориентацию индикатора прогресса (Горизонтальная или Вертикальная).

Отображать строку прогресса– Если опция выбрана, то в поле индикатора прогресса отображается текстовая строка. Обычно она показывает текущее значение прогресса выполнения задачи. Содержимое строки задается в поле справа от флажка. Здесь Вы можете ввести выражение, возвращающее значение типа String - текст, который и будет отображаться в поле элемента управления. Вы можете использовать в выражении две локальные переменные: value (хранит значение текущего прогресса) и percent (хранит текущее значение процента выполненной задачи).
Пример строки: percent + " процент(ов) выполнен(о)"

Минимум – Минимальное значение индикатора прогресса. 

Максимум – Максимальное значение индикатора прогресса.

Значение прогресса – Выражение, возвращающее значение типа double - значение прогресса выполнения задачи.
Простейший пример: если Вы хотите отслеживать с помощью индикатора прогресса ход течения времени, напишите здесь time() 

Фиксированный – Логическое выражение, определяющее, находится ли индикатор прогресса в фиксированном или нефиксированном режиме. В нефиксированном режиме элемент управления будет показывать с помощью анимации, что выполняется задача неопределенной длительности. 

Дополнительные свойства

Цвет фона – Задает цвет фона индикатора прогресса. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

X – X-координата верхнего левого угла индикатора прогресса.

Y – Y-координата верхнего левого угла индикатора прогресса.

Ширина – Ширина индикатора прогресса (в пикселах).

Высота – Высота индикатора прогресса (в пикселах).

Разрешить программное управление – Если опция выбрана, то элемент управления будет представлен в модели как Java объект, и будет доступен из кода по имени. С помощью программного интерфейса Вы сможете изменять визуальные свойства элемента управления и тем самым управлять ее внешним видом во время выполнения модели.

Динамические свойства
Имя Тип Описание
Количество int Количество экземпляров данного элемента управления. Если Вы оставите это поле пустым, то будет создан только один такой элемент управления.
Видимость boolean Видимость элемента управления. Строка прогресса будет видна, если заданное здесь выражение будет истинно (true), в противном случае она отображаться не будет.
X double X-координата верхнего левого угла индикатора прогресса.
Y double Y-координата верхнего левого угла индикатора прогресса.
Ширина int Ширина индикатора прогресса (в пикселах).
Высота int Высота индикатора прогресса (в пикселах)

См. также

 Перемещение фигуры

 Изменение размера фигуры

 Управление видимостью фигур

 Справочник классов: Класс ShapeProgressBar