public class JProgressBar extends JComponent implements SwingConstants, Accessible
JProgressBar使用BoundedRangeModel为数据模型,以表示该任务的当前状态的value财产,和minimum和maximum属性表示点的开始和结束,分别。
为了表示未知长度的任务正在执行,您可以将进度条放在不确定的模式中。而酒吧是不确定的模式,它将不断地表明工作正在发生。一旦你确定任务的长度和进度,你应该更新进度条的值,并将其转换为确定的模式。
这里是创建一个进度条的一个例子,在task是一个对象(代表作品),返回任务的进度信息:
ProgressBar =新jprogressbar(0,任务。getlengthoftask());进度条的值(0);进度条。setstringpainted(真的);这里是查询任务的当前状态的一个例子,并使用返回的值来更新进度条:
ProgressBar。setValue(任务。getcurrent());这里是把一个进度条为不确定的模式的一个例子,然后切换回确定模式一旦任务的长度是已知的:
新jprogressbar() ProgressBar =;……当(最初)未知长度的任务开始时:进度条。setindeterminate(真的);……做一些工作,得到任务的长度…setmaximum(newlength)了;ProgressBar setValue(价值);进度条。setindeterminate(假);
完整的例子和文档看How to Monitor Progress,java教程中的一部分。
警告: Swing是线程不安全的。更多信息见Swing's Threading Policy。
警告:序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4,为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。
| Modifier and Type | Class and Description |
|---|---|
protected class |
JProgressBar.AccessibleJProgressBar
这个类实现了对
JProgressBar类可访问性支持。
|
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| Modifier and Type | Field and Description |
|---|---|
protected ChangeEvent |
changeEvent
只有一个
ChangeEvent是需要每个实例事件以来唯一有趣的属性是不变的,这是进步吧。
|
protected ChangeListener |
changeListener
听改变事件的进度条的发送模式,调整改变他们对这个进度条注册事件侦听器。
|
protected BoundedRangeModel |
model
保存进度条的数据的对象。
|
protected int |
orientation
进度条是否是水平的或垂直的。
|
protected boolean |
paintBorder
是否显示进度条的边框。
|
protected boolean |
paintString
是否显示进度条上的一个文本字符串。
|
protected String |
progressString
一个可以在进度条上显示的可选字符串。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTBOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WESTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| Constructor and Description |
|---|
JProgressBar()
创建一个显示边框但没有进度字符串的水平进度条。
|
JProgressBar(BoundedRangeModel newModel)
创建一个使用指定的模型来保持进度条数据的水平进度条。
|
JProgressBar(int orient)
创建一个具有指定方向的进度条,可以
SwingConstants.VERTICAL或
SwingConstants.HORIZONTAL。
|
JProgressBar(int min, int max)
用指定的最小值和最大值创建一个水平进度条。
|
JProgressBar(int orient, int min, int max)
使用指定的方向、最小值和最大值创建一个进度条。
|
| Modifier and Type | Method and Description |
|---|---|
void |
addChangeListener(ChangeListener l)
添加指定的
ChangeListener的进度条。
|
protected ChangeListener |
createChangeListener()
子类,需要办理更改事件的模型不同,可以重写该返回一个自定义
ChangeListener实现的一个实例。
|
protected void |
fireStateChanged()
送
ChangeEvent,其来源是这样的
JProgressBar,所有
ChangeListeners有兴趣
ChangeEvents注册。
|
AccessibleContext |
getAccessibleContext()
获取与此相关的
AccessibleContext
JProgressBar。
|
ChangeListener[] |
getChangeListeners()
返回所有的
ChangeListeners数组添加到这个进度条
addChangeListener。
|
int |
getMaximum()
从
BoundedRangeModel回报进度条的
maximum价值。
|
int |
getMinimum()
从
BoundedRangeModel回报进度条的
minimum价值。
|
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()
重置UI属性从目前看价值和感觉。
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, updateadd, 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, validateTreeaction, 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycleprotected int orientation
HORIZONTAL。
setOrientation(int)
protected boolean paintBorder
true。
protected BoundedRangeModel model
protected String progressString
null。设置为一个非
null价值并不意味着该字符串将显示。要显示的字符串,
paintString必须
true。
protected boolean paintString
false。设置为
true导致进步的文本显示为进度条上呈现。如果
progressString是
null,完工百分比显示进度条。否则,该
progressString进度条上呈现。
protected transient ChangeEvent changeEvent
ChangeEvent是需要每个实例事件以来唯一有趣的属性是不变的,这是进步吧。事件是懒洋洋地创建事件通知是开的第一时间。
fireStateChanged()
protected ChangeListener changeListener
createChangeListener()
public JProgressBar()
public JProgressBar(int orient)
SwingConstants.VERTICAL或
SwingConstants.HORIZONTAL。默认情况下,一个边框被绘制,但一个进程字符串不是。初始值和最小值分别为0,最大值为100。
orient -进度条预期的方向
IllegalArgumentException -如果
orient是非法的值
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)
public JProgressBar(int min,
int max)
将进度条的数据BoundedRangeModel处理任何可能出现的问题的不当设置最小,初始,在进度条的最大值。详细内容见BoundedRangeModel文档。
min -进度条的最小值
max -进度条的最大值
BoundedRangeModel,
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)
public JProgressBar(int orient,
int min,
int max)
将进度条的数据BoundedRangeModel处理任何可能出现的问题的不当设置最小,初始,在进度条的最大值。详细内容见BoundedRangeModel文档。
orient -进度条预期的方向
min -进度条的最小值
max -进度条的最大值
IllegalArgumentException -如果
orient是非法的值
BoundedRangeModel,
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)
public JProgressBar(BoundedRangeModel newModel)
newModel -进度栏的数据模型
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)
public int getOrientation()
SwingConstants.VERTICAL或
SwingConstants.HORIZONTAL,根据进度条的方向。默认的方向是
SwingConstants.HORIZONTAL。
HORIZONTAL或
VERTICAL
setOrientation(int)
public void setOrientation(int newOrientation)
newOrientation进度条的方向,必须
SwingConstants.VERTICAL或
SwingConstants.HORIZONTAL。默认的方向是
SwingConstants.HORIZONTAL。
newOrientation -
HORIZONTAL或
VERTICAL
IllegalArgumentException -如果
newOrientation是非法的值
getOrientation()
public boolean isStringPainted()
stringPainted属性的值。
stringPainted属性的值
setStringPainted(boolean),
setString(java.lang.String)
public void setStringPainted(boolean b)
stringPainted属性的值,从而确定进度栏应该呈现进度线。默认的是
false,意义没有字符串是画。一些外观和感觉可能不支持进度字符串或可能会支持他们,只有当进度条在确定模式。
b -
true如果进度条应该呈现一个字符串
isStringPainted(),
setString(java.lang.String)
public String getString()
String表示。默认情况下,这将返回一个基于
getPercentComplete返回的值的百分比
String简单。一个例子是“42%”。你可以改变这个叫
setString。
null
setString(java.lang.String)
public void setString(String s)
null,意味着使用一个简单的成字符串的内置行为。如果你提供了一个自定义进度字符串和要还原为内置的行为,设置字符串返回
null。
进步的字符串是画只有isStringPainted方法返回true。
s -进步字符串的值
getString(),
setStringPainted(boolean),
isStringPainted()
public double getPercentComplete()
public boolean isBorderPainted()
borderPainted财产。
borderPainted属性的值
setBorderPainted(boolean)
public void setBorderPainted(boolean b)
borderPainted属性,这是
true如果进度条应该油漆边界。此属性的默认值是
true。一些外观和感觉可能无法实现绘制的边框,他们将忽略此属性。
b -
true如果进度条应该油漆边界;否则,
false
isBorderPainted()
protected void paintBorder(Graphics g)
borderPainted属性
true。
paintBorder 方法重写,继承类
JComponent
g -其中
Graphics背景画的边界
JComponent.paint(java.awt.Graphics),
JComponent.setBorder(javax.swing.border.Border),
isBorderPainted(),
setBorderPainted(boolean)
public ProgressBarUI getUI()
ProgressBarUI对象,使得这部分
public void setUI(ProgressBarUI ui)
ui -
ProgressBarUI对象
UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
updateUI 方法重写,继承类
JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID 方法重写,继承类
JComponent
JComponent.getUIClassID(),
UIDefaults.getUI(javax.swing.JComponent)
protected ChangeListener createChangeListener()
ChangeListener实现的一个实例。默认
ChangeListener只需调用
fireStateChanged方法提出
ChangeEvents,已直接添加进度条的
ChangeListeners。
public void addChangeListener(ChangeListener l)
ChangeListener的进度条。
l -
ChangeListener添加
public void removeChangeListener(ChangeListener l)
ChangeListener。
l -
ChangeListener删除
public ChangeListener[] getChangeListeners()
ChangeListeners数组添加到这个进度条
addChangeListener。
ChangeListeners说如果没有听众已添加一个空数组
protected void fireStateChanged()
ChangeEvent,其来源是这样的
JProgressBar,所有
ChangeListeners有
ChangeEvents注册兴趣。这种方法称为一次
ChangeEvent从模型获得。
事件实例被创建时,储存在changeEvent。
public BoundedRangeModel getModel()
BoundedRangeModel
setModel(javax.swing.BoundedRangeModel),
BoundedRangeModel
public void setModel(BoundedRangeModel newModel)
JProgressBar使用。请注意,
BoundedRangeModel的
extent不使用,并将
0。
newModel -
BoundedRangeModel使用
public int getValue()
value从
BoundedRangeModel。该值总是在最小值和最大值之间,包括。
setValue(int),
BoundedRangeModel.getValue()
public int getMinimum()
BoundedRangeModel回报进度条的
minimum价值。
setMinimum(int),
BoundedRangeModel.getMinimum()
public int getMaximum()
BoundedRangeModel回报进度条的
maximum价值。
setMaximum(int),
BoundedRangeModel.getMaximum()
public void setValue(int n)
n进度栏的当前值。此方法将新的值转发到模型中。
数据模型(对BoundedRangeModel实例)处理任何数学问题从分配错误的价值观所产生的。详细内容见BoundedRangeModel文档。
如果新值与前一个值不同,则通知所有更改侦听器。
public void setMinimum(int n)
n。
数据模型(一BoundedRangeModel实例)处理任何数学问题从分配错误的价值观所产生的。详细内容见BoundedRangeModel文档。
如果最小值与以前的最小值不同,则通知所有更改侦听器。
public void setMaximum(int n)
n
潜在的BoundedRangeModel处理任何数学问题从分配错误的价值观所产生的。详细内容见BoundedRangeModel文档。
如果最大值与以前的最大值不同,则通知所有更改侦听器。
。public void setIndeterminate(boolean newValue)
indeterminate属性,它确定进度栏是确定的或不确定的模式。一个不确定的进度条连续显示动画,表明未知长度的操作正在发生。默认情况下,这个属性是
false。一些看起来和感觉可能不支持不确定的进度条;他们会忽略该属性。
看到使用不确定的进度条的例子How to Monitor Progress。
newValue -
true如果进度条应改定模式;
false是否应该恢复正常。
isIndeterminate(),
BasicProgressBarUI
public boolean isIndeterminate()
indeterminate属性的值。
indeterminate属性的值
setIndeterminate(boolean)
protected String paramString()
JProgressBar字符串表示形式。此方法的目的是只用于调试的目的。返回的字符串的内容和格式可能会在实现中有所不同。返回的字符串是空的但可能不
null。
paramString 方法重写,继承类
JComponent
JProgressBar字符串表示形式
public AccessibleContext getAccessibleContext()
AccessibleContext
JProgressBar。进度条,该
AccessibleContext以一
AccessibleJProgressBar形式。一个新的
AccessibleJProgressBar实例被创建时。
getAccessibleContext 接口
Accessible
getAccessibleContext 方法重写,继承类
Component
AccessibleJProgressBar作为本
JProgressBar的
AccessibleContext
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.