模块 java.desktop
包 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。

有时，当对话框可见时，进度条将在调用 setProgress 时更新。 setProgress 不会总是更新进度条，它只会在进度明显显着时才会执行。

有关更多文档和示例，请参阅 如何监控进度，The Java Tutorial. 中的一个部分

自从：
1.2
参见：

  • 字段详细信息

    • 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 - 范围的上限
      参见：

  • 方法详情

    • setProgress

      public void setProgress(int nv)
      指示正在监视的操作的进度。如果指定的值 >= 最大值，则关闭进度监视器。
      参数：
      nv - 指定当前值的 int，介于为此组件指定的最大值和最小值之间
      参见：

    • close

      public void close()
      表示操作完成。当 setProgress 设置的值 >= max 时会自动发生这种情况，但如果操作提前结束，它可能会提前调用。

    • getMinimum

      public int getMinimum()
      返回最小值——进度值的下限。
      返回：
      表示最小值的 int
      参见：

    • setMinimum

      public void setMinimum(int m)
      指定最小值。
      参数：
      m - 指定最小值的 int
      参见：

    • getMaximum

      public int getMaximum()
      返回最大值——进度值的较高端。
      返回：
      表示最大值的 int
      参见：

    • setMaximum

      public void setMaximum(int m)
      指定最大值。
      参数：
      m - 指定最大值的 int
      参见：

    • isCanceled

      public boolean isCanceled()
      如果用户点击取消按钮或关闭进度对话框，则返回 true。
      返回：
      如果用户点击取消按钮或关闭进度对话框则为真

    • setMillisToDecideToPopup

      public void setMillisToDecideToPopup(int millisToDecideToPopup)
      指定在决定是否弹出进度监视器之前等待的时间量。
      参数：
      millisToDecideToPopup - 指定等待时间的整数，以毫秒为单位
      参见：

    • getMillisToDecideToPopup

      public int getMillisToDecideToPopup()
      返回此对象在决定是否弹出进度监视器之前等待的时间。
      返回：
      此对象在决定是否弹出进度监视器之前等待的时间（以毫秒为单位）
      参见：

    • setMillisToPopup

      public void setMillisToPopup(int millisToPopup)
      指定弹出窗口出现所需的时间量。 （如果预测剩余时间小于此时间，则不会显示弹出窗口。）
      参数：
      millisToPopup - 以毫秒为单位指定时间的 int
      参见：

    • getMillisToPopup

      public int getMillisToPopup()
      返回弹出窗口出现所需的时间。
      返回：
      弹出窗口出现所需的时间（以毫秒为单位）
      参见：

    • setNote

      public void setNote(String  note)
      指定与进度消息一起显示的附加注解。例如，用于显示在多文件复制过程中当前正在复制哪个文件。
      参数：
      note - 一个字符串，指定要显示的注释
      参见：

    • getNote

      public String  getNote()
      指定与进度消息一起显示的附加注解。
      返回：
      一个字符串，指定要显示的注释
      参见：

    • getAccessibleContext

      public AccessibleContext  getAccessibleContext()
      为 ProgressMonitor 获取 AccessibleContext
      指定者：
      getAccessibleContext 在接口 Accessible 中
      返回：
      AccessibleContext 为 ProgressMonitor
      自从：
      1.5