Package org.processmining.plugins.inductiveVisualMiner.export

Class GuaranteedProgressMonitor

  • All Implemented Interfaces:
    javax.accessibility.Accessible
    public class GuaranteedProgressMonitor
extends java.lang.Object
implements javax.accessibility.Accessible
    A class to monitor the progress of some operation. If it looks like the operation will take a while, a progress dialog will be popped up. When the ProgressMonitor is created it is given a numeric range and a descriptive string. As the operation progresses, call the setProgress method to indicate how far along the [min,max] range the operation is. Initially, there is no ProgressDialog. After the first millisToDecideToPopup milliseconds (default 500) the progress monitor will predict how long the operation will take. If it is longer than millisToPopup (default 2000, 2 seconds) a ProgressDialog will be popped up.

    From time to time, when the Dialog box is visible, the progress bar will be updated when setProgress is called. setProgress won't always update the progress bar, it will only be done if the amount of progress is visibly significant.

    For further documentation and examples see How to Monitor Progress, a section in The Java Tutorial.

    Author:
    James Gosling, Lynn Monsanto (accessibility)
    See Also:
    ProgressMonitorInputStream

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected javax.accessibility.AccessibleContext accessibleContext
      The AccessibleContext for the ProgressMonitor

    • Constructor Summary

      Constructors 
      Constructor Description
      GuaranteedProgressMonitor​(java.awt.Component parentComponent, java.lang.Object message, java.lang.String note, int min, int max)
      Constructs a graphic object that shows progress, typically by filling in a rectangular bar as the process nears completion.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      Indicate that the operation is complete.
      static java.awt.Window findWindow​(java.awt.Component c)  
      javax.accessibility.AccessibleContext getAccessibleContext()
      Gets the AccessibleContext for the ProgressMonitor
      int getMaximum()
      Returns the maximum value -- the higher end of the progress value.
      int getMinimum()
      Returns the minimum value -- the lower end of the progress value.
      java.lang.String getNote()
      Specifies the additional note that is displayed along with the progress message.
      boolean isCanceled()
      Returns true if the user hits the Cancel button in the progress dialog.
      void setIndeterminate()  
      void setMaximum​(int m)
      Specifies the maximum value.
      void setMinimum​(int m)
      Specifies the minimum value.
      void setNote​(java.lang.String note)
      Specifies the additional note that is displayed along with the progress message.
      void setProgress​(int nv)
      Indicate the progress of the operation being monitored.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • accessibleContext

        protected javax.accessibility.AccessibleContext accessibleContext
        The AccessibleContext for the ProgressMonitor
        Since:
        1.5

    • Constructor Detail

      • GuaranteedProgressMonitor

        public GuaranteedProgressMonitor​(java.awt.Component parentComponent,
                                 java.lang.Object message,
                                 java.lang.String note,
                                 int min,
                                 int max)
        Constructs a graphic object that shows progress, typically by filling in a rectangular bar as the process nears completion.
        Parameters:
        parentComponent - the parent component for the dialog box
        message - a descriptive message that will be shown to the user to indicate what operation is being monitored. This does not change as the operation progresses. See the message parameters to methods in JOptionPane.message for the range of values.
        note - a short note describing the state of the operation. As the operation progresses, you can call setNote to change the note displayed. This is used, for example, in operations that iterate through a list of files to show the name of the file being processes. If note is initially null, there will be no note line in the dialog box and setNote will be ineffective
        min - the lower bound of the range
        max - the upper bound of the range
        See Also:
        JDialog, JOptionPane

    • Method Detail

      • setProgress

        public void setProgress​(int nv)
        Indicate the progress of the operation being monitored. If the specified value is >= the maximum, the progress monitor is closed.
        Parameters:
        nv - an int specifying the current value, between the maximum and minimum specified for this component
        See Also:
        setMinimum(int), setMaximum(int), close()

      • setIndeterminate

        public void setIndeterminate()

      • close

        public void close()
        Indicate that the operation is complete. This happens automatically when the value set by setProgress is >= max, but it may be called earlier if the operation ends early.

      • getMinimum

        public int getMinimum()
        Returns the minimum value -- the lower end of the progress value.
        Returns:
        an int representing the minimum value
        See Also:
        setMinimum(int)

      • setMinimum

        public void setMinimum​(int m)
        Specifies the minimum value.
        Parameters:
        m - an int specifying the minimum value
        See Also:
        getMinimum()

      • getMaximum

        public int getMaximum()
        Returns the maximum value -- the higher end of the progress value.
        Returns:
        an int representing the maximum value
        See Also:
        setMaximum(int)

      • setMaximum

        public void setMaximum​(int m)
        Specifies the maximum value.
        Parameters:
        m - an int specifying the maximum value
        See Also:
        getMaximum()

      • isCanceled

        public boolean isCanceled()
        Returns true if the user hits the Cancel button in the progress dialog.

      • setNote

        public void setNote​(java.lang.String note)
        Specifies the additional note that is displayed along with the progress message. Used, for example, to show which file the is currently being copied during a multiple-file copy.
        Parameters:
        note - a String specifying the note to display
        See Also:
        getNote()

      • getNote

        public java.lang.String getNote()
        Specifies the additional note that is displayed along with the progress message.
        Returns:
        a String specifying the note to display
        See Also:
        setNote(java.lang.String)

      • getAccessibleContext

        public javax.accessibility.AccessibleContext getAccessibleContext()
        Gets the AccessibleContext for the ProgressMonitor
        Specified by:
        getAccessibleContext in interface javax.accessibility.Accessible
        Returns:
        the AccessibleContext for the ProgressMonitor
        Since:
        1.5

      • findWindow

        public static java.awt.Window findWindow​(java.awt.Component c)