Interface IRunnableContext

All Known Subinterfaces:
ICompareContainer, ILaunchConfigurationDialog, IProgressService, IWizardContainer, IWizardContainer2, IWorkbenchSiteProgressService, IWorkbenchWindow
All Known Implementing Classes:
ApplicationWindow, CompareEditorInput, HistoryPageCompareEditorInput, PageCompareEditorInput, ParticipantPageCompareEditorInput, ProgressMonitorDialog, SaveableCompareEditorInput, SyncInfoCompareInput, WizardDialog

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.

See Also:
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    run(boolean fork, boolean cancelable, IRunnableWithProgress runnable)
    Runs the given IRunnableWithProgress 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 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.

      Parameters:
      fork - true if the runnable should be run in a separate thread, and false to run in the same thread
      cancelable - true to enable the cancelation, and false to make the operation uncancellable
      runnable - the runnable to run
      Throws:
      InvocationTargetException - wraps any exception or error which occurs while running the runnable
      InterruptedException - propagated by the context if the runnable acknowledges cancelation by throwing this exception. This should not be thrown if cancelable is false.