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