javax.swing
Class ProgressMonitor

java.lang.Object
  |
  +--javax.swing.ProgressMonitor

public class ProgressMonitor
extends Object

Unsafe:


Field Summary
private  Object[] cancelOption
           
private  JDialog dialog
           
private  int lastDisp
           
private  int max
           
private  Object message
           
private  int millisToDecideToPopup
           
private  int millisToPopup
           
private  int min
           
private  JProgressBar myBar
           
private  String note
           
private  JLabel noteLabel
           
private  JOptionPane pane
           
private  Component parentComponent
           
private  int reportDelta
           
private  ProgressMonitor root
           
private  long T0
           
private  int v
           
 
Constructor Summary
  ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
          Enabled: Constructs a graphic object that shows progress, typically by filling in a rectangular bar as the process nears completion.
private ProgressMonitor(Component parentComponent, Object message, String note, int min, int max, ProgressMonitor group)
           
 
Method Summary
 void close()
          Enabled: Indicate that the operation is complete.
 int getMaximum()
          Enabled: Returns the maximum value -- the higher end of the progress value.
 int getMillisToDecideToPopup()
          Enabled: Returns the amount of time this object waits before deciding whether or not to popup a progress monitor.
 int getMillisToPopup()
          Enabled: Returns the amount of time it will take for the popup to appear.
 int getMinimum()
          Enabled: Returns the minimum value -- the lower end of the progress value.
 String getNote()
          Enabled: Specifies the additional note that is displayed along with the progress message.
 boolean isCanceled()
          Enabled: Returns true if the user hits the Cancel button in the progress dialog.
 void setMaximum(int m)
          Enabled: Specifies the maximum value.
 void setMillisToDecideToPopup(int millisToDecideToPopup)
          Enabled: Specifies the amount of time to wait before deciding whether or not to popup a progress monitor.
 void setMillisToPopup(int millisToPopup)
          Enabled: Specifies the amount of time it will take for the popup to appear.
 void setMinimum(int m)
          Enabled: Specifies the minimum value.
 void setNote(String note)
          Enabled: Specifies the additional note that is displayed along with the progress message.
 void setProgress(int nv)
          Enabled: 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

root

private ProgressMonitor root

dialog

private JDialog dialog

pane

private JOptionPane pane

myBar

private JProgressBar myBar

noteLabel

private JLabel noteLabel

parentComponent

private Component parentComponent

note

private String note

cancelOption

private Object[] cancelOption

message

private Object message

T0

private long T0

millisToDecideToPopup

private int millisToDecideToPopup

millisToPopup

private int millisToPopup

min

private int min

max

private int max

v

private int v

lastDisp

private int lastDisp

reportDelta

private int reportDelta
Constructor Detail

ProgressMonitor

public ProgressMonitor(Component parentComponent,
                       Object message,
                       String note,
                       int min,
                       int max)
Enabled: 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

ProgressMonitor

private ProgressMonitor(Component parentComponent,
                        Object message,
                        String note,
                        int min,
                        int max,
                        ProgressMonitor group)
Method Detail

setProgress

public void setProgress(int nv)
Enabled: 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()

close

public void close()
Enabled: 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()
Enabled: 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)
Enabled: Specifies the minimum value.

Parameters:
m - an int specifying the minimum value
See Also:
getMinimum()

getMaximum

public int getMaximum()
Enabled: 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)
Enabled: Specifies the maximum value.

Parameters:
m - an int specifying the maximum value
See Also:
getMaximum()

isCanceled

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


setMillisToDecideToPopup

public void setMillisToDecideToPopup(int millisToDecideToPopup)
Enabled: Specifies the amount of time to wait before deciding whether or not to popup a progress monitor.

Parameters:
millisToDecideToPopup - an int specifying the time to wait, in milliseconds
See Also:
getMillisToDecideToPopup()

getMillisToDecideToPopup

public int getMillisToDecideToPopup()
Enabled: Returns the amount of time this object waits before deciding whether or not to popup a progress monitor.

See Also:
setMillisToDecideToPopup(int)

setMillisToPopup

public void setMillisToPopup(int millisToPopup)
Enabled: Specifies the amount of time it will take for the popup to appear. (If the predicted time remaining is less than this time, the popup won't be displayed.)

Parameters:
millisToPopup - an int specifying the time in milliseconds
See Also:
getMillisToPopup()

getMillisToPopup

public int getMillisToPopup()
Enabled: Returns the amount of time it will take for the popup to appear.

See Also:
setMillisToPopup(int)

setNote

public void setNote(String note)
Enabled: 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 String getNote()
Enabled: 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)


comments?