模块  java.desktop
软件包  javax.swing

Class 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
    • 字段详细信息

      • accessibleContext

        protected AccessibleContext accessibleContext
        AccessibleContextProgressMonitor
        从以下版本开始:
        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 - 范围的上限
        另请参见:
        JDialogJOptionPane
    • 方法详细信息

      • 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()
        获取 AccessibleContextProgressMonitor
        Specified by:
        getAccessibleContext ,界面 Accessible
        结果
        AccessibleContextProgressMonitor
        从以下版本开始:
        1.5