Класс JProgressBar

javax.swing.JProgressBar

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

@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 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`JProgressBar.AccessibleJProgressBar`	Этот класс реализует поддержку специальных возможностей для класса `JProgressBar`.

Вложенные классы и интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected ChangeEvent`	`changeEvent`	Для каждого экземпляра требуется только один `ChangeEvent`, поскольку единственное интересное свойство события — неизменяемый источник, которым является индикатор выполнения.
`protected ChangeListener`	`changeListener`	Прослушивает события изменения, отправляемые моделью индикатора выполнения, и повторно отправляет их зарегистрированным для этого индикатора слушателям событий изменения.
`protected BoundedRangeModel`	`model`	Объект, содержащий данные индикатора выполнения.
`protected int`	`orientation`	Ориентация индикатора выполнения: горизонтальная или вертикальная.
`protected boolean`	`paintBorder`	Нужно ли отображать рамку вокруг индикатора выполнения.
`protected boolean`	`paintString`	Нужно ли отображать текстовую строку на индикаторе выполнения.
`protected String`	`progressString`	Необязательная строка, которую можно отобразить на индикаторе выполнения.

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Краткое описание конструкторов

Конструктор	Описание
`JProgressBar()`	Создаёт горизонтальный индикатор выполнения с рамкой, но без строки состояния.
`JProgressBar(int orient)`	Создаёт индикатор выполнения с указанной ориентацией, которая может быть `SwingConstants.VERTICAL` или `SwingConstants.HORIZONTAL`.
`JProgressBar(int min, int max)`	Создаёт горизонтальный индикатор выполнения с указанными минимальным и максимальным значениями.
`JProgressBar(int orient, int min, int max)`	Создаёт индикатор выполнения с указанными ориентацией, минимальным и максимальным значениями.
`JProgressBar(BoundedRangeModel newModel)`	Создаёт горизонтальный индикатор выполнения, использующий указанную модель для хранения своих данных.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addChangeListener(ChangeListener l)`	Добавляет указанный `ChangeListener` к индикатору выполнения.
`protected ChangeListener`	`createChangeListener()`	Подклассы, которым требуется иначе обрабатывать события изменения модели, могут переопределить этот метод, чтобы он возвращал экземпляр пользовательской реализации `ChangeListener`.
`protected void`	`fireStateChanged()`	Отправляет `ChangeEvent`, источником которого является этот `JProgressBar`, всем `ChangeListener`s, зарегистрировавшим интерес к `ChangeEvent`s.
`AccessibleContext`	`getAccessibleContext()`	Получает `AccessibleContext`, связанный с этим `JProgressBar`.
`ChangeListener[]`	`getChangeListeners()`	Возвращает массив всех `ChangeListener`s, добавленных к этому индикатору выполнения с помощью `addChangeListener`.
`int`	`getMaximum()`	Возвращает значение `maximum` индикатора выполнения из `BoundedRangeModel`.
`int`	`getMinimum()`	Возвращает значение `minimum` индикатора выполнения из `BoundedRangeModel`.
`BoundedRangeModel`	`getModel()`	Возвращает модель данных, используемую этим индикатором выполнения.
`int`	`getOrientation()`	Возвращает `SwingConstants.VERTICAL` или `SwingConstants.HORIZONTAL` в зависимости от ориентации индикатора выполнения.
`double`	`getPercentComplete()`	Возвращает процент выполнения, отображаемый индикатором.
`String`	`getString()`	Возвращает `String` представление текущего хода выполнения.
`ProgressBarUI`	`getUI()`	Возвращает объект оформления, который отображает этот компонент.
`String`	`getUIClassID()`	Возвращает имя класса оформления, который отображает этот компонент.
`int`	`getValue()`	Возвращает текущее значение `value` индикатора выполнения из `BoundedRangeModel`.
`boolean`	`isBorderPainted()`	Возвращает свойство `borderPainted`.
`boolean`	`isIndeterminate()`	Возвращает значение свойства `indeterminate`.
`boolean`	`isStringPainted()`	Возвращает значение свойства `stringPainted`.
`protected void`	`paintBorder(Graphics g)`	Отрисовывает рамку индикатора выполнения, если свойство `borderPainted` имеет значение `true`.
`protected String`	`paramString()`	Возвращает строковое представление этого `JProgressBar`.
`void`	`removeChangeListener(ChangeListener l)`	Удаляет `ChangeListener` из индикатора выполнения.
`void`	`setBorderPainted(boolean b)`	Задаёт свойство `borderPainted`, значение которого должно быть `true`, если индикатор выполнения должен отрисовывать рамку.
`void`	`setIndeterminate(boolean newValue)`	Задаёт свойство `indeterminate` индикатора выполнения, определяющее, находится ли он в определённом или неопределённом режиме.
`void`	`setMaximum(int n)`	Устанавливает максимальное значение индикатора выполнения (хранящееся в его модели данных) равным `n`.
`void`	`setMinimum(int n)`	Устанавливает минимальное значение индикатора выполнения (хранящееся в его модели данных) равным `n`.
`void`	`setModel(BoundedRangeModel newModel)`	Задаёт модель данных, используемую `JProgressBar`.
`void`	`setOrientation(int newOrientation)`	Задаёт ориентацию индикатора выполнения: `newOrientation`. Допустимы значения `SwingConstants.VERTICAL` или `SwingConstants.HORIZONTAL`.
`void`	`setString(String s)`	Задаёт значение строки состояния.
`void`	`setStringPainted(boolean b)`	Задаёт значение свойства `stringPainted`, определяющего, должен ли индикатор выполнения отображать строку состояния.
`void`	`setUI(ProgressBarUI ui)`	Задаёт объект оформления, который отображает этот компонент.
`void`	`setValue(int n)`	Устанавливает текущее значение индикатора выполнения равным `n`.
`void`	`updateUI()`	Сбрасывает свойство пользовательского интерфейса до значения, заданного текущим оформлением.

Методы, объявленные в классе JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Методы, объявленные в классе Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

orientation

protected int orientation

Является ли индикатор выполнения горизонтальным или вертикальным. По умолчанию — HORIZONTAL.

См. также:

paintBorder

protected boolean paintBorder

Следует ли отображать рамку вокруг индикатора выполнения. По умолчанию — true.

См. также:

model

protected BoundedRangeModel model

Объект, содержащий данные индикатора выполнения.

См. также:

progressString

protected String progressString

Необязательная строка, которую можно отображать на индикаторе выполнения. По умолчанию — null. Установка значения, отличного от null, не означает, что строка будет отображаться. Чтобы отображать строку, paintString должно иметь значение true.

См. также:

paintString

protected boolean paintString

Следует ли отображать текстовую строку на индикаторе выполнения. По умолчанию — false. Установка значения true приводит к отображению текстового представления хода выполнения на индикаторе. Если progressString имеет значение null, на индикаторе отображается процент завершения. В противном случае на индикаторе отображается progressString.

См. также:

changeEvent

protected transient ChangeEvent changeEvent

Для каждого экземпляра требуется только один ChangeEvent, поскольку единственное интересующее свойство события — неизменяемый источник, которым является индикатор выполнения. Событие создаётся отложенно при первом отправлении уведомления о событии.

См. также:

changeListener

protected ChangeListener changeListener

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

См. также:

Подробное описание конструкторов

JProgressBar

public JProgressBar()

Создаёт горизонтальный индикатор выполнения с рамкой, но без строки состояния. Начальное и минимальное значения равны 0, максимальное — 100.

См. также:

JProgressBar

public JProgressBar(int orient)

Создаёт индикатор выполнения с заданной ориентацией, которая может быть SwingConstants.VERTICAL или SwingConstants.HORIZONTAL. По умолчанию отображается рамка, но не строка состояния. Начальное и минимальное значения равны 0, максимальное — 100.

Параметры:

orient — требуемая ориентация индикатора выполнения

Исключения:

IllegalArgumentException — если orient имеет недопустимое значение

См. также:

JProgressBar

public JProgressBar(int min, int max)

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

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

Параметры:

min — минимальное значение индикатора выполнения

max — максимальное значение индикатора выполнения

См. также:

JProgressBar

public JProgressBar(int orient, int min, int max)

Создаёт индикатор выполнения с заданными ориентацией, минимальным и максимальным значениями. По умолчанию отображается рамка, но не строка состояния. Устанавливает начальное значение индикатора равным заданному минимуму.

Параметры:

orient — требуемая ориентация индикатора выполнения

min — минимальное значение индикатора выполнения

max — максимальное значение индикатора выполнения

Исключения:

IllegalArgumentException — если orient имеет недопустимое значение

См. также:

JProgressBar

public JProgressBar(BoundedRangeModel newModel)

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

Параметры:

newModel — модель данных индикатора выполнения

См. также:

Подробное описание методов

getOrientation

public int getOrientation()

Возвращает SwingConstants.VERTICAL или SwingConstants.HORIZONTAL в зависимости от ориентации индикатора выполнения. Ориентация по умолчанию — SwingConstants.HORIZONTAL.

Возвращает:

HORIZONTAL или VERTICAL

См. также:

setOrientation

@BeanProperty(preferred=true, visualUpdate=true, description="Set the progress bar's orientation.") public void setOrientation(int newOrientation)

Устанавливает ориентацию индикатора выполнения в newOrientation, которая должна быть SwingConstants.VERTICAL или SwingConstants.HORIZONTAL. Ориентация по умолчанию — SwingConstants.HORIZONTAL.

Параметры:

newOrientation — HORIZONTAL или VERTICAL

Исключения:

IllegalArgumentException — если newOrientation имеет недопустимое значение

См. также:

isStringPainted

public boolean isStringPainted()

Возвращает значение свойства stringPainted.

Возвращает:

значение свойства stringPainted

См. также:

setStringPainted

@BeanProperty(visualUpdate=true, description="Whether the progress bar should render a string.") public void setStringPainted(boolean b)

Устанавливает значение свойства stringPainted, определяющего, должен ли индикатор отображать строку состояния. По умолчанию — false, то есть строка не отображается. Некоторые стили оформления могут не поддерживать строки состояния или поддерживать их только в режиме определённого прогресса.

Параметры:

b — true, если индикатор должен отображать строку

См. также:

getString

public String getString()

Возвращает String представление текущего хода выполнения. По умолчанию возвращается простая строка с процентом String, рассчитанным на основе значения, возвращаемого getPercentComplete. Например: «42%». Это можно изменить, вызвав setString.

Возвращает:

значение строки состояния или простую строку с процентом, если строка состояния равна null

См. также:

setString

@BeanProperty(visualUpdate=true, description="Specifies the progress string to paint") public void setString(String s)

Устанавливает значение строки состояния. По умолчанию эта строка равна null, что означает использование встроенного поведения с отображением простого процентного значения. Если задана пользовательская строка состояния и требуется вернуться к встроенному поведению, снова установите для строки значение null.

Строка состояния отображается, только если метод isStringPainted возвращает true.

Параметры:

s — значение строки состояния

См. также:

getPercentComplete

@BeanProperty(bound=false) public double getPercentComplete()

Возвращает процент выполнения для индикатора. Обратите внимание, что это число находится в диапазоне от 0.0 до 1.0.

Возвращает:: процент выполнения для этого индикатора

isBorderPainted

public boolean isBorderPainted()

Возвращает значение свойства borderPainted.

Возвращает:

значение свойства borderPainted

См. также:

setBorderPainted

@BeanProperty(visualUpdate=true, description="Whether the progress bar should paint its border.") public void setBorderPainted(boolean b)

Устанавливает свойство borderPainted, которое имеет значение true, если индикатор должен отображать рамку. Значение этого свойства по умолчанию — true. Некоторые стили оформления могут не реализовывать отображение рамок и будут игнорировать это свойство.

Параметры:

b — true, если индикатор должен отображать рамку; в противном случае — false

См. также:

paintBorder

protected void paintBorder(Graphics g)

Отрисовывает рамку индикатора, если свойство borderPainted имеет значение true.

Переопределяет:

paintBorder в классе JComponent

Параметры:

g — контекст Graphics, в котором следует отрисовать рамку

См. также:

getUI

public ProgressBarUI getUI()

Возвращает объект стиля оформления, который отображает этот компонент.

Переопределяет:: getUI в классе JComponent
Возвращает:: объект ProgressBarUI, который отображает этот компонент

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(ProgressBarUI ui)

Устанавливает объект стиля оформления, который отображает этот компонент.

Параметры:

ui — объект ProgressBarUI

См. также:

updateUI

public void updateUI()

Сбрасывает свойство UI, устанавливая значение из текущего стиля оформления.

Переопределяет:

updateUI в классе JComponent

См. также:

getUIClassID

@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the look-and-feel class.") public String getUIClassID()

Возвращает имя класса стиля оформления, который отображает этот компонент.

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "ProgressBarUI"

См. также:

createChangeListener

protected ChangeListener createChangeListener()

Подклассы, которым требуется иначе обрабатывать события изменения модели, могут переопределить этот метод, чтобы вернуть экземпляр пользовательской реализации ChangeListener. Реализация ChangeListener просто вызывает метод fireStateChanged для перенаправления ChangeEvent обработчикам ChangeListener, непосредственно добавленным к индикатору выполнения.

Возвращает:

экземпляр пользовательской реализации ChangeListener.

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

Добавляет указанный ChangeListener к индикатору выполнения.

Параметры:: l — добавляемый ChangeListener

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener из индикатора выполнения.

Параметры:: l — удаляемый ChangeListener

getChangeListeners

@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()

Возвращает массив всех ChangeListener, добавленных к этому индикатору выполнения с помощью addChangeListener.

Возвращает:: все добавленные ChangeListener или пустой массив, если обработчики не добавлены
Начиная с версии:: 1.4

fireStateChanged

protected void fireStateChanged()

Отправляет ChangeEvent, источником которого является этот JProgressBar, всем ChangeListener, зарегистрировавшим интерес к ChangeEvent. Этот метод вызывается каждый раз при получении от модели ChangeEvent.

При необходимости экземпляр события создаётся и сохраняется в changeEvent.

См. также:

getModel

public BoundedRangeModel getModel()

Возвращает модель данных, используемую этим индикатором выполнения.

Возвращает:

используемую в данный момент BoundedRangeModel

См. также:

setModel

@BeanProperty(bound=false, expert=true, description="The data model used by the JProgressBar.") public void setModel(BoundedRangeModel newModel)

Устанавливает модель данных, используемую JProgressBar. Обратите внимание, что BoundedRangeModel — extent не используется и устанавливается в значение 0.

Параметры:: newModel — используемая BoundedRangeModel

getValue

public int getValue()

Возвращает текущее value индикатора выполнения из BoundedRangeModel. Значение всегда находится в пределах от минимального до максимального включительно.

Возвращает:

текущее значение индикатора выполнения

См. также:

getMinimum

public int getMinimum()

Возвращает minimum значение индикатора выполнения из BoundedRangeModel.

Возвращает:

минимальное значение индикатора выполнения

См. также:

getMaximum

public int getMaximum()

Возвращает maximum значение индикатора выполнения из BoundedRangeModel.

Возвращает:

максимальное значение индикатора выполнения

См. также:

setValue

@BeanProperty(bound=false, preferred=true, description="The progress bar's current value.") public void setValue(int n)

Устанавливает текущее значение индикатора выполнения равным n. Этот метод передаёт новое значение модели.

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

Если новое значение отличается от предыдущего, всем обработчикам изменений отправляется уведомление.

Параметры:

n — новое значение

См. также:

setMinimum

@BeanProperty(bound=false, preferred=true, description="The progress bar's minimum value.") public void setMinimum(int n)

Устанавливает минимальное значение индикатора выполнения (хранящееся в модели данных индикатора) равным n.

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

Параметры:

n — новое минимальное значение

См. также:

setMaximum

@BeanProperty(bound=false, preferred=true, description="The progress bar's maximum value.") public void setMaximum(int n)

Устанавливает максимальное значение индикатора выполнения (хранящееся в модели данных индикатора) равным n.

Базовая BoundedRangeModel обрабатывает любые математические проблемы, возникающие при присваивании некорректных значений. Подробности см. в документации BoundedRangeModel.

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

Параметры:

n — новое максимальное значение

См. также:

setIndeterminate

public void setIndeterminate(boolean newValue)

Устанавливает свойство indeterminate индикатора выполнения, определяющее, находится ли он в определённом или неопределённом режиме. Индикатор с неопределённым ходом выполнения непрерывно отображает анимацию, указывающую на выполнение операции неизвестной длительности. По умолчанию это свойство имеет значение false. Некоторые стили оформления могут не поддерживать неопределённые индикаторы выполнения и будут игнорировать это свойство.

Примеры использования неопределённых индикаторов выполнения см. в разделе Как отслеживать ход выполнения.

Параметры:

newValue — true, если индикатор следует переключить в неопределённый режим; false, если его следует вернуть в обычный режим.

Начиная с версии:

1.4

См. также:

isIndeterminate

@BeanProperty(bound=false, description="Is the progress bar indeterminate (true) or normal (false)?") public boolean isIndeterminate()

Возвращает значение свойства indeterminate.

Возвращает:

значение свойства indeterminate

Начиная с версии:

1.4

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JProgressBar

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this ProgressBar.") public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим JProgressBar. Для индикаторов выполнения AccessibleContext имеет вид AccessibleJProgressBar. При необходимости создаётся новый экземпляр AccessibleJProgressBar.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleJProgressBar, выполняющий роль AccessibleContext этого JProgressBar

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JProgressBar.html