模块  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
        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 - 范围的上限
        另请参见：
        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 - 指定要显示的注释的String
        另请参见：
        getNote()

      • getNote

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

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        获取 AccessibleContext的 ProgressMonitor
        Specified by:
        getAccessibleContext ，界面 Accessible
        结果
        AccessibleContext为 ProgressMonitor
        从以下版本开始：
        1.5