public interface IRunnableContext
IRunnableWithProgress
.
The context is responsible for displaying a progress indicator and Cancel
button to the end user while the operation is in progress; the context
supplies a progress monitor to be used from code running inside the operation.
Note that an IRunnableContext
is not a runnable itself.
For examples of UI components which implement this interface,
see ApplicationWindow
, ProgressMonitorDialog
,
and WizardDialog
.
Modifier and Type | Method and Description |
---|---|
void |
run(boolean fork,
boolean cancelable,
IRunnableWithProgress runnable)
Runs the given
IRunnableWithProgress in this context. |
void run(boolean fork, boolean cancelable, IRunnableWithProgress runnable) throws InvocationTargetException, InterruptedException
Runs the given IRunnableWithProgress
in this context.
For example, if this is a ProgressMonitorDialog
then the runnable
is run using this dialog's progress monitor.
If fork
is false
, the current thread is used
to run the runnable. Note that if fork
is true
,
it is unspecified whether or not this method blocks until the runnable
has been run. Implementers should document whether the runnable is run
synchronously (blocking) or asynchronously (non-blocking), or if no
assumption can be made about the blocking behaviour.
fork
- true
if the runnable should be run in a separate thread,
and false
to run in the same threadcancelable
- true
to enable the cancelation, and
false
to make the operation uncancellablerunnable
- the runnable to runInvocationTargetException
- wraps any exception or error which occurs
while running the runnableInterruptedException
- propagated by the context if the runnable
acknowledges cancelation by throwing this exception. This should not be thrown
if cancelable is false
.Guidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.