ProgressMonitor

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 ProgressMonitor

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。

当可以看到 Dialog 框时，调用 setProgress 可以更新进度条。setProgress 并不总是更新该进度条，仅当进度量明显增多时才进行更新。

有关此内容的更多文档和示例，请参阅 The Java Tutorial 中的 How to Monitor Progress 一节。

另请参见：: ProgressMonitorInputStream

嵌套类摘要
`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`

字段详细信息

accessibleContext

protected AccessibleContext accessibleContext

ProgressMonitor 的 AccessibleContext

从以下版本开始：: 1.5

构造方法详细信息

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

方法详细信息

setProgress

public void setProgress(int nv)

指示正被监视操作的进度。如果指定值 >= 最大值，则关闭进度监视器。

参数：: nv - 指定当前值的 int，位于为此组件指定的最大值和最小值之间
另请参见：: setMinimum(int), setMaximum(int), close()

close

public void close()

指示操作已完成。当 setProgress 设置的值 >= 最大值时，此过程自动发生，但是如果提前结束该操作，则可以提前调用它。

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()

如果用户单击进度对话框中的 Cancel 按钮，则返回 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()

获得 ProgressMonitor 的 AccessibleContext。

指定者：: 接口 Accessible 中的 getAccessibleContext

返回：: ProgressMonitor 的 AccessibleContext
从以下版本开始：: 1.5

概述