- java.lang.Object
-
- javax.swing.ProgressMonitor
-
- 实现的所有接口
-
Accessible
public class ProgressMonitor extends Object implements Accessible
用于监视某些操作进度的类。 如果操作看起来需要一段时间,则会弹出一个进度对话框。 创建ProgressMonitor时,会给它一个数字范围和一个描述性字符串。 随着操作的进行,调用setProgress方法指示操作的[min,max]范围有多远。 最初,没有ProgressDialog。 在第一个millisToDecideToPopup毫秒(默认值为500)之后,进度监视器将预测操作将花费多长时间。 如果它长于millisToPopup(默认为2000,2秒),则会弹出ProgressDialog。有时,当对话框可见时,调用setProgress时将更新进度条。 setProgress不会总是更新进度条,只有当进度量明显很大时才会进行。
有关更多文档和示例,请参阅“Java教程”中的 How to Monitor Progress部分。
- 从以下版本开始:
- 1.2
- 另请参见:
-
ProgressMonitorInputStream
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
ProgressMonitor.AccessibleProgressMonitor
AccessibleProgressMonitor
实现ProgressMonitor
类的可访问性支持。
-
字段汇总
字段 变量和类型 字段 描述 protected AccessibleContext
accessibleContext
AccessibleContext
为ProgressMonitor
-
构造方法摘要
构造方法 构造器 描述 ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
构造一个显示进度的图形对象,通常在过程接近完成时填充矩形条。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
close()
表示操作已完成。AccessibleContext
getAccessibleContext()
获取AccessibleContext
的ProgressMonitor
int
getMaximum()
返回最大值 - 进度值的较高端。int
getMillisToDecideToPopup()
返回此对象在决定是否弹出进度监视器之前等待的时间。int
getMillisToPopup()
返回弹出窗口显示所需的时间。int
getMinimum()
返回最小值 - 进度值的下限。String
getNote()
指定与进度消息一起显示的附加注释。boolean
isCanceled()
如果用户点击“取消”按钮或关闭进度对话框,则返回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)
指示正在监视的操作的进度。
-
-
-
字段详细信息
-
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext
为ProgressMonitor
- 从以下版本开始:
- 1.5
-
-
构造方法详细信息
-
ProgressMonitor
public ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
构造一个显示进度的图形对象,通常在过程接近完成时填充矩形条。- 参数
-
parentComponent
- 对话框的父组件 -
message
- 将向用户显示的描述性消息,以指示正在监视的操作。 这不会随着操作的进行而改变。 有关值的范围,请参阅JOptionPane.message
中方法的消息参数。 -
note
- 描述操作状态的简短说明。 随着操作的进行,您可以调用setNote来更改显示的注释。 例如,这用于迭代文件列表以显示正在处理的文件的名称的操作。 如果note最初为null,则对话框中将没有注释行,并且setNote将无效 -
min
- 范围的下限 -
max
- 范围的上限 - 另请参见:
-
JDialog
,JOptionPane
-
-
方法详细信息
-
setProgress
public void setProgress(int nv)
指示正在监视的操作的进度。 如果指定的值> =最大值,则关闭进度监视器。- 参数
-
nv
- 指定当前值的int,在此组件指定的最大值和最小值之间 - 另请参见:
-
setMinimum(int)
,setMaximum(int)
,close()
-
close
public void close()
表示操作已完成。 当setProgress设置的值> = max时会自动发生,但如果操作提前结束,则可以提前调用它。
-
getMinimum
public int getMinimum()
返回最小值 - 进度值的下限。- 结果
- 表示最小值的int
- 另请参见:
-
setMinimum(int)
-
setMinimum
public void setMinimum(int m)
指定最小值。- 参数
-
m
- 指定最小值的int - 另请参见:
-
getMinimum()
-
getMaximum
public int getMaximum()
返回最大值 - 进度值的较高端。- 结果
- 表示最大值的int
- 另请参见:
-
setMaximum(int)
-
setMaximum
public void setMaximum(int m)
指定最大值。- 参数
-
m
- 指定最大值的int - 另请参见:
-
getMaximum()
-
isCanceled
public boolean isCanceled()
如果用户点击“取消”按钮或关闭进度对话框,则返回true。- 结果
- 如果用户点击“取消”按钮或关闭进度对话框,则为true
-
setMillisToDecideToPopup
public void setMillisToDecideToPopup(int millisToDecideToPopup)
指定在决定是否弹出进度监视器之前等待的时间。- 参数
-
millisToDecideToPopup
- 指定等待时间的int,以毫秒为单位 - 另请参见:
-
getMillisToDecideToPopup()
-
getMillisToDecideToPopup
public int getMillisToDecideToPopup()
返回此对象在决定是否弹出进度监视器之前等待的时间。- 结果
- 此对象在决定是否弹出进度监视器之前等待的时间量(以毫秒为单位)
- 另请参见:
-
setMillisToDecideToPopup(int)
-
setMillisToPopup
public void setMillisToPopup(int millisToPopup)
指定弹出窗口显示所需的时间。 (如果预测的剩余时间少于此时间,则不会显示弹出窗口。)- 参数
-
millisToPopup
- 指定以毫秒为单位的时间的int - 另请参见:
-
getMillisToPopup()
-
getMillisToPopup
public int getMillisToPopup()
返回弹出窗口显示所需的时间。- 结果
- 弹出窗口显示的时间长度(以毫秒为单位)
- 另请参见:
-
setMillisToPopup(int)
-
setNote
public void setNote(String note)
指定与进度消息一起显示的附加注释。 例如,用于显示多文件复制期间当前正在复制的文件。- 参数
-
note
- 指定要显示的注释的String - 另请参见:
-
getNote()
-
getNote
public String getNote()
指定与进度消息一起显示的附加注释。- 结果
- 指定要显示的注释的String
- 另请参见:
-
setNote(java.lang.String)
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
获取AccessibleContext
的ProgressMonitor
- Specified by:
-
getAccessibleContext
,界面Accessible
- 结果
-
AccessibleContext
为ProgressMonitor
- 从以下版本开始:
- 1.5
-
-