Класс 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, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. Пожалуйста, обратитесь к XMLEncoder.

Since:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JProgressBar.AccessibleJProgressBar`	Этот класс реализует поддержку доступности для класса `JProgressBar`.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.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`	Необязательная строка, которая может быть отображена на полосе прогресса.

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе javax.swing.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)`	Создаёт горизонтальную полосу прогресса, использующую указанную модель для хранения данных полосы прогресса.

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

Modifier and Type	Method	Description
`void`	`addChangeListener(ChangeListener l)`	Добавляет указанное `ChangeListener` в полосу прогресса.
`protected ChangeListener`	`createChangeListener()`	Подклассы, которые хотят обрабатывать события изменения от модели по-другому, могут переопределить этот метод, чтобы вернуть экземпляр кастомной реализации `ChangeListener`.
`protected void`	`fireStateChanged()`	Отправляет `ChangeEvent`, источником которого является этот `JProgressBar`, всем `ChangeListener`, которые зарегистрировали интерес к `ChangeEvent`.
`AccessibleContext`	`getAccessibleContext()`	Получает `AccessibleContext`, связанное с этим `JProgressBar`.
`ChangeListener[]`	`getChangeListeners()`	Возвращает массив всех `ChangeListener`, добавленных в эту полосу прогресса с помощью `addChangeListener`.
`int`	`getMaximum()`	Возвращает значение `maximum` полосы прогресса из `BoundedRangeModel`.
`int`	`getMinimum()`	Возвращает значение `minimum` полосы прогресса из `BoundedRangeModel`.
`BoundedRangeModel`	`getModel()`	Возвращает модель данных, используемую этой полосой прогресса.
`int`	`getOrientation()`	Возвращает `SwingConstants.VERTICAL` или `SwingConstants.HORIZONTAL` в зависимости от ориентации полосы прогресса.
`double`	`getPercentComplete()`	Возвращает процент завершения для полосы прогресса.
`String`	`getString()`	Возвращает строковое представление текущего прогресса.
`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()`	Сбрасывает свойство UI до значения из текущей темы.

Методы, объявленные в классе javax.swing.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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.lang.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.

Параметры:

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, что означает, что строка не отображается. Некоторые стили оформления могут не поддерживать строки прогресса или поддерживать их только когда индикатор прогресса находится в режиме определения.

Parameters:

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

See Also:

getString

public String getString()

Возвращает строковое String текущего прогресса. По умолчанию возвращает простую процентную String, основанную на значении, возвращаемом из getPercentComplete. Пример: "42%". Вы можете изменить это, вызвав setString.

Returns:

значение строки прогресса или простая строка процента, если строка прогресса null

See Also:

setString

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

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

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

Parameters:

s - значение строки прогресса

See Also:

getPercentComplete

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

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

Returns:: процент выполнения для этого индикатора прогресса

isBorderPainted

public boolean isBorderPainted()

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

Returns:

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

See Also:

setBorderPainted

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

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

Parameters:

b - true, если индикатор прогресса должен рисовать свою границу; иначе, false

See Also:

paintBorder

protected void paintBorder(Graphics g)

Рисует границу индикатора прогресса, если свойство borderPainted равно true.

Overrides:

paintBorder в классе JComponent

Parameters:

g - Graphics контекст, в рамках которого должна быть нарисована граница

See Also:

getUI

public ProgressBarUI getUI()

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

Overrides:: getUI в классе JComponent
Returns:: объект ProgressBarUI, который отрисовывает этот компонент

setUI

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

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

Parameters:

ui - объект ProgressBarUI

See Also:

updateUI

public void updateUI()

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

Overrides:

updateUI в классе JComponent

See Also:

getUIClassID

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

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

Overrides:

getUIClassID в классе JComponent

Returns:

строка "ProgressBarUI"

See Also:

createChangeListener

protected ChangeListener createChangeListener()

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

Returns:

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

See Also:

addChangeListener

public void addChangeListener(ChangeListener l)

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

Parameters:: l - добавляемый ChangeListener

removeChangeListener

public void removeChangeListener(ChangeListener l)

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

Parameters:: l - удаляемый ChangeListener

getChangeListeners

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

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

Returns:: все добавленные ChangeListener или пустой массив, если слушатели не добавлены
Since:: 1.4

fireStateChanged

protected void fireStateChanged()

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

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

See Also:

getModel

public BoundedRangeModel getModel()

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

Returns:

текущая используемая BoundedRangeModel

See Also:

setModel

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

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

Parameters:: newModel - используемая BoundedRangeModel

getValue

public int getValue()

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

Возвращает:

текущее значение полосы прогресса

См. также:

getMinimum

public int getMinimum()

Возвращает минимальное значение полосы прогресса от BoundedRangeModel.

Возвращает:

минимальное значение полосы прогресса

См. также:

getMaximum

public int getMaximum()

Возвращает максимальное значение полосы прогресса от 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, если она должна вернуться в нормальный режим.

Since:

1.4

См. также:

isIndeterminate

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

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

Возвращает:

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

Since:

1.4

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

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

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JProgressBar.html