org.netbeans.api.progress/1 1.32.1

org.netbeans.api.progress.aggregate
Class AggregateProgressFactory

java.lang.Object
  extended by org.netbeans.api.progress.aggregate.AggregateProgressFactory

public final class AggregateProgressFactory
extends Object

Factory for creation of aggregate progress indication handles and individual contributor instances. For a more simple version of progress indication, see ProgressHandleFactory


Method Summary
static JLabel createDetailLabelComponent(AggregateProgressHandle handle)
          Get the detail messages component for use in custom dialogs, the task won't show in the progress bar anymore.The text of the label is changed by calls to contributors' progress(String) methods.
static AggregateProgressHandle createHandle(String displayName, ProgressContributor[] contributors, Cancellable allowToCancel, Action linkOutput)
          Create an aggregating progress ui handle for a long lasting task.
static JLabel createMainLabelComponent(AggregateProgressHandle handle)
          Get the task title component for use in custom dialogs, the task won't show in the progress bar anymore.
static JComponent createProgressComponent(AggregateProgressHandle handle)
          Get the progress bar component for use in custom dialogs, the task won't show in the progress bar anymore.
static ProgressContributor createProgressContributor(String trackingId)
           
static AggregateProgressHandle createSystemHandle(String displayName, ProgressContributor[] contributors, Cancellable allowToCancel, Action linkOutput)
          Create an aggregating progress ui handle for a long lasting task.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createHandle

public static AggregateProgressHandle createHandle(String displayName,
                                                   ProgressContributor[] contributors,
                                                   Cancellable allowToCancel,
                                                   Action linkOutput)
Create an aggregating progress ui handle for a long lasting task.

Parameters:
contributors - the initial set of progress indication contributors that are aggregated in the UI.
allowToCancel - either null, if the task cannot be cancelled or an instance of Cancellable that will be called when user triggers cancel of the task.
linkOutput - an Action instance that links the running task in the progress bar to an output of the task. The action is assumed to open the apropriate component with the task's output.
displayName - to be shown in the progress UI
Returns:
an instance of ProgressHandle, initialized but not started.

createProgressContributor

public static ProgressContributor createProgressContributor(String trackingId)

createSystemHandle

public static AggregateProgressHandle createSystemHandle(String displayName,
                                                         ProgressContributor[] contributors,
                                                         Cancellable allowToCancel,
                                                         Action linkOutput)
Create an aggregating progress ui handle for a long lasting task.

Parameters:
contributors - the initial set of progress indication contributors that are aggregated in the UI.
allowToCancel - either null, if the task cannot be cancelled or an instance of Cancellable that will be called when user triggers cancel of the task.
linkOutput - an Action instance that links the running task in the progress bar to an output of the task. The action is assumed to open the apropriate component with the task's output.
displayName - to be shown in the progress UI
Returns:
an instance of ProgressHandle, initialized but not started.

createProgressComponent

public static JComponent createProgressComponent(AggregateProgressHandle handle)
Get the progress bar component for use in custom dialogs, the task won't show in the progress bar anymore.

Returns:
the component to use in custom UI.
Since:
org.netbeans.api.progress 1.3

createMainLabelComponent

public static JLabel createMainLabelComponent(AggregateProgressHandle handle)
Get the task title component for use in custom dialogs, the task won't show in the progress bar anymore. The text of the label is changed by calls to handle's setDisplayName() method.

Returns:
the component to use in custom UI.
Since:
org.netbeans.api.progress 1.8

createDetailLabelComponent

public static JLabel createDetailLabelComponent(AggregateProgressHandle handle)
Get the detail messages component for use in custom dialogs, the task won't show in the progress bar anymore.The text of the label is changed by calls to contributors' progress(String) methods.

Returns:
the component to use in custom UI.
Since:
org.netbeans.api.progress 1.8

org.netbeans.api.progress/1 1.32.1

Built on February 14 2013.  |  Portions Copyright 1997-2013 Oracle. All rights reserved.