Package org.eclipse.jface.operation
Interface IRunnableContext
- All Known Subinterfaces:
ICompareContainer
,ILaunchConfigurationDialog
,IProgressService
,IWizardContainer
,IWizardContainer2
,IWorkbenchSiteProgressService
,IWorkbenchWindow
- All Known Implementing Classes:
ApplicationWindow
,CompareContainer
,CompareEditorInput
,HistoryPageCompareEditorInput
,PageCompareEditorInput
,ParticipantPageCompareEditorInput
,ProgressMonitorDialog
,SaveableCompareEditorInput
,SyncInfoCompareInput
,WizardDialog
,WorkbenchWindow
public interface IRunnableContext
Interface for UI components which can execute a long-running operation
in the form of an
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
.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
run
(boolean fork, boolean cancelable, IRunnableWithProgress runnable) Runs the givenIRunnableWithProgress
in this context.
-
Method Details
-
run
void run(boolean fork, boolean cancelable, IRunnableWithProgress runnable) throws InvocationTargetException, InterruptedException Runs the given
IRunnableWithProgress
in this context. For example, if this is aProgressMonitorDialog
then the runnable is run using this dialog's progress monitor.If
fork
isfalse
, the current thread is used to run the runnable. Note that iffork
istrue
, 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.- Parameters:
fork
-true
if the runnable should be run in a separate thread, andfalse
to run in the same threadcancelable
-true
to enable the cancelation, andfalse
to make the operation uncancellablerunnable
- the runnable to run- Throws:
InvocationTargetException
- 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 isfalse
.
-