Класс 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.