oracle.javatools.dialogs
Class ProgressMonitor

Deprecated.replaced by oracle.javatools.dialogs.progress.ProgressMonitor
and related classes.

public class ProgressMonitor

extends java.lang.Object

A class to monitor the progress of some operation, based on Swing's
ProgressMonitor. This implementation conforms to UI
specifications and offers the following additional features:

a configurable title for the progress dialog.

indeterminate progress indication.

optional visibility of the progress bar in the dialog.

an optionally cancellable dialog.

a section of the dialog for logging the details of actions.

By default, the progress monitor will not use a delay before making
the dialog visible. Recommended settings for the popup decision and
delay are 500 and 2000 milliseconds respectively.
Thread advice - instances of this class should be configured and their
methods invoked from a consumer worker thread and not the AWTbasicdo
event thread, which must be left free to process events.

ProgressMonitor

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.

title - the title for the dialog box.

message - The main process step: broadly tells the user what step in
the overall process is currently being executed. If possible, it
includes additional information tracking the process of the step
such as time remaining or number of bytes received. Provided you
pass a String into this method, you can change the text at
any time while the operation proceeds by calling setMessage().

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.

ProgressMonitor

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.

title - the title for the dialog box.

message - The main process step: broadly tells the user what step in
the overall process is currently being executed. If possible, it
includes additional information tracking the process of the step
such as time remaining or number of bytes received. You can change
the text at any time while the operation proceeds by calling
setMessage().

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.

isCancellable

display

public void display()

Deprecated.

Forces the progress dialog to be displayed, regardless of timing.
If consumer code does not update the component with intermittent changes
to the progress value, this method should be called to ensure dialog
visibility. Do not invoke from the AWT event thread.