Module  java.desktop
软件包  javax.swing

Class ProgressMonitor

  • All Implemented Interfaces:
    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
        AccessibleContext为 ProgressMonitor
        从以下版本开始：
        1.5

    • 构造方法详细信息

      • ProgressMonitor

        public ProgressMonitor​(Component parentComponent,
                       Object message,
                       String note,
                       int min,
                       int max)
        构造一个显示进度的图形对象，通常通过填充矩形栏来完成过程。
        参数
        parentComponent - 对话框的父组件
        message - 将向用户显示描述性消息，以指示正在监视的操作。 这不会随着操作的进行而改变。 有关值的范围，请参阅JOptionPane.message中的方法的消息参数。
        note - 描述操作状态的简短说明。 随着操作的进行，您可以调用setNote来更改显示的音符。 例如，这用于遍历文件列表的操作，以显示正在处理的文件的名称。 如果注释最初为空，对话框中不会有注释行，而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 - 指定要显示的笔记的字符串
        另请参见：
        getNote()

      • getNote

        public String getNote​()
        指定与进度消息一起显示的附加注释。
        结果
        一个指定要显示的笔记的字符串
        另请参见：
        setNote(java.lang.String)

      • getAccessibleContext

        public AccessibleContext getAccessibleContext​()
        获得 AccessibleContext的 ProgressMonitor
        Specified by:
        getAccessibleContext接口 Accessible
        结果
        AccessibleContext为 ProgressMonitor
        从以下版本开始：
        1.5