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.AccessibleJComponent
Container.AccessibleAWTContainer
Component.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_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
ABORT, 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 ,所有
ChangeListener s有兴趣
ChangeEvent s注册。
|
AccessibleContext |
getAccessibleContext()
获取与此相关的
AccessibleContext
JProgressBar 。
|
ChangeListener[] |
getChangeListeners()
返回所有的
ChangeListener s数组添加到这个进度条
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, update
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
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, 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, transferFocusUpCycle
protected 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
方法提出
ChangeEvent
s,已直接添加进度条的
ChangeListener
s。
public void addChangeListener(ChangeListener l)
ChangeListener
的进度条。
l
-
ChangeListener
添加
public void removeChangeListener(ChangeListener l)
ChangeListener
。
l
-
ChangeListener
删除
public ChangeListener[] getChangeListeners()
ChangeListener
s数组添加到这个进度条
addChangeListener
。
ChangeListener
s说如果没有听众已添加一个空数组
protected void fireStateChanged()
ChangeEvent
,其来源是这样的
JProgressBar
,所有
ChangeListener
s有
ChangeEvent
s注册兴趣。这种方法称为一次
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.