java.lang.Object javax.swing.ProgressMonitor
public class ProgressMonitor
监视某个操作的进度的类。如果表现为操作需要一段时间,则会弹出进度对话框。创建 ProgressMonitor 时,向它提供数字范围和描述字符串。在操作进行时,调用 setProgress 方法,以指示操作的 [min,max] 范围有多大。最初,不存在 ProgressDialog。第一个 millisToDecideToPopup 毫秒(默认值为 500)以后,进度监视器会预测该操作将花费多长时间。如果大于 millisToPopup(默认值为 2000,即 2 秒),则弹出 ProgressDialog。
当可以看到 Dialog 框时,调用 setProgress 可以更新进度条。setProgress 并不总是更新该进度条,仅当进度量明显增多时才进行更新。
有关此内容的更多文档和示例,请参阅 The Java Tutorial 中的 How to Monitor Progress 一节。
嵌套类摘要 | |
---|---|
protected class |
ProgressMonitor.AccessibleProgressMonitor AccessibleProgressMonitor 实现 ProgressMonitor 类的可访问性支持。 |
字段摘要 | |
---|---|
protected AccessibleContext |
accessibleContext ProgressMonitor 的 AccessibleContext |
构造方法摘要 | |
---|---|
ProgressMonitor(Component parentComponent, Object message, String note, int min, int max) 构造一个图形对象,它一般会根据进程的完成情况通过填充矩形条来显示进度。 |
方法摘要 | |
---|---|
void |
close() 指示操作已完成。 |
AccessibleContext |
getAccessibleContext() 获得 ProgressMonitor 的 AccessibleContext 。 |
int |
getMaximum() 返回最大值 - 进度值的较高端。 |
int |
getMillisToDecideToPopup() 返回在确定是否弹出进度监视器之前此对象等待的时间量。 |
int |
getMillisToPopup() 返回显示弹出监视器花费的时间量。 |
int |
getMinimum() 返回最小值 - 进度值的较低端。 |
String |
getNote() 指定随进度消息一起显示的其他注释。 |
boolean |
isCanceled() 如果用户单击进度对话框中的 Cancel 按钮,则返回 true。 |
void |
setMaximum(int m) 指定最大值。 |
void |
setMillisToDecideToPopup(int millisToDecideToPopup) 指定在确定是否弹出进度监视器之前要等待的时间量。 |
void |
setMillisToPopup(int millisToPopup) 指定显示弹出监视器花费的时间量。 |
void |
setMinimum(int m) 指定最小值。 |
void |
setNote(String note) 指定与进度消息一起显示的其他注释。 |
void |
setProgress(int nv) 指示正被监视操作的进度。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
protected AccessibleContext accessibleContext
ProgressMonitor
的
AccessibleContext
构造方法详细信息 |
---|
public ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
parentComponent
- 对话框的父组件
message
- 要显示给用户的描述消息,以指示在监视什么操作。这不随操作进度而更改。请参阅
JOptionPane.message
中方法的 message 参数,了解值的范围。
note
- 描述操作状态的简短注释。随着操作的进行,可以调用 setNote 来更改显示的注释。例如,这可用于迭代文件列表以显示正在处理的文件名称的操作中。如果注释最初为 null,则对话框中将不存在注释行,并且 setNote 无效
min
- 范围的下边界
max
- 范围的上边界
JDialog
,
JOptionPane
方法详细信息 |
---|
public void setProgress(int nv)
nv
- 指定当前值的 int,位于为此组件指定的最大值和最小值之间
setMinimum(int)
,
setMaximum(int)
,
close()
public void close()
public int getMinimum()
setMinimum(int)
public void setMinimum(int m)
m
- 指定最小值的 int
getMinimum()
public int getMaximum()
setMaximum(int)
public void setMaximum(int m)
m
- 指定最大值的 int
getMaximum()
public boolean isCanceled()
public void setMillisToDecideToPopup(int millisToDecideToPopup)
millisToDecideToPopup
- 指定要等待的时间(以毫秒为单位)的 int
getMillisToDecideToPopup()
public int getMillisToDecideToPopup()
public void setMillisToPopup(int millisToPopup)
millisToPopup
- 指定时间(以毫秒为单位)的 int
getMillisToPopup()
public int getMillisToPopup()
setMillisToPopup(int)
public void setNote(String note)
note
- 指定要显示的注释的 String
getNote()
public String getNote()
setNote(java.lang.String)
public AccessibleContext getAccessibleContext()
ProgressMonitor
的
AccessibleContext
。
Accessible
中的
getAccessibleContext
ProgressMonitor
的
AccessibleContext