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
.
Copyright (c) 2000, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.