Класс JProgressBar

@JavaBean(defaultProperty="UI", description="A component that displays an integer value.") public class JProgressBar extends JComponent implements SwingConstants, Accessible

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

JProgressBar использует BoundedRangeModel в качестве своей модели данных, при этом свойство value представляет текущее состояние задачи, а свойства minimum и maximum представляют начальную и конечную точки соответственно.

Чтобы указать, что задача неизвестной длины выполняется, вы можете перевести полосу прогресса в режим неопределенности. Пока полоса находится в режиме неопределенности, она постоянно анимируется, чтобы показать, что работа выполняется. Как только вы сможете определить длину задачи и количество прогресса, вы должны обновить значение полосы прогресса и переключиться обратно в режим определенности.

Вот пример создания полосы прогресса, где task — это объект (представляющий некую работу), который возвращает информацию о прогрессе задачи:

progressBar = new JProgressBar(0, task.getLengthOfTask());
progressBar.setValue(0);
progressBar.setStringPainted(true);

Вот пример запроса текущего состояния задачи и использования возвращаемого значения для обновления полосы прогресса:

progressBar.setValue(task.getCurrent());

Вот пример перевода полосы прогресса в режим неопределенности, а затем — обратно в режим определенности после того, как длина задачи станет известна:

progressBar = new JProgressBar();
...//when the task of (initially) unknown length begins:
progressBar.setIndeterminate(true);
...//do some work; get length of task...
progressBar.setMaximum(newLength);
progressBar.setValue(newValue);
progressBar.setIndeterminate(false);

Для полных примеров и дополнительной документации см. Как отслеживать прогресс — раздел в учебнике Java.

Предупреждение: Swing не является потокобезопасным. Более подробную информацию см. в Политике потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими на одной версии Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. См. XMLEncoder.