Module java.desktop
Package javax.swing

Class 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不会总是更新进度条，只有在进度显著时才会这样做。

有关更多文档和示例，请参阅如何监视进度，这是《Java教程》中的一节。

自1.2版本起:
1.2
另请参阅:

  • Field Details

    • accessibleContext

      protected AccessibleContext accessibleContext
      ProgressMonitor的AccessibleContext
      自1.5版本起:
      1.5

  • Constructor Details

    • ProgressMonitor

      public ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
      构造一个显示进度的图形对象，通常通过填充矩形条来显示进程接近完成。
      参数:
      parentComponent - 对话框框的父组件
      message - 一个描述性消息，将显示给用户以指示正在监视的操作。随着操作的进行，此消息不会更改。有关值范围，请参阅JOptionPane.message中方法的消息参数。
      note - 描述操作状态的简短注释。随着操作的进行，您可以调用setNote来更改显示的注释。例如，在迭代文件列表以显示正在处理的文件名时使用。如果note最初为null，则对话框框中将没有注释行，并且setNote将无效。
      min - 范围的下限
      max - 范围的上限
      另请参阅:

  • Method Details

    • setProgress

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

    • close

      public void close()
      表示操作已完成。当由setProgress设置的值>=最大值时，将自动发生，但如果操作提前结束，也可以提前调用。

    • 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。
      返回:
      如果用户点击取消按钮或关闭进度对话框，则返回true

    • setMillisToDecideToPopup

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

    • 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中
      返回:
      ProgressMonitor的AccessibleContext
      自1.5版本起:
      1.5