Interface ITask
- All Superinterfaces:
org.eclipse.jface.dialogs.IDialogPage
- All Known Implementing Classes:
CompoundTask
,SimpleTask
,TreeCompoundTask
public interface ITask
extends org.eclipse.jface.dialogs.IDialogPage
-
Method Summary
Modifier and TypeMethodDescriptionCalled just before the UI for the task is disposed, it will be used by the wizard.String[]
Called by the container wizard if it follows the 'pull' mechanism for error discovery.void
setContext
(IWizardContext context) Called just before the UI for this Task is shown.void
setErrorHints
(Object[] errorHints) Called just before the UI for this Task is shown...in case the task is being shown in response to a request to fix an error.void
setUIProvider
(WizardBase wizard) Called upon instantiation to allow a task to interact with the containing wizard.Methods inherited from interface org.eclipse.jface.dialogs.IDialogPage
createControl, dispose, getControl, getDescription, getErrorMessage, getImage, getMessage, getTitle, performHelp, setDescription, setImageDescriptor, setTitle, setVisible
-
Method Details
-
setContext
Called just before the UI for this Task is shown. Intended for the UI to prepare itself by processing the context passed in. The context will depend on the wizard.- Parameters:
context
- The context in which the Subtask UI will be shown. Its content depend on individual wizards.
-
getContext
IWizardContext getContext()Called just before the UI for the task is disposed, it will be used by the wizard. The context returned should contain the complete updated context for the wizard. This context should be useable as is and should not require any additional processing before use.- Returns:
- complete context for the wizard with all updates that result from operations performed as part of this task.
-
setUIProvider
Called upon instantiation to allow a task to interact with the containing wizard. This instance should be used to perform operations like enabling or disabling other tasks in the current invocation as well as to display or hide linked popup windows.- Parameters:
wizard
- instance of WizardBase containing this task instance.
-
setErrorHints
Called just before the UI for this Task is shown...in case the task is being shown in response to a request to fix an error. The argument is supposed to be an object array that provides additional information as to the specific error condition in the current context.- Parameters:
errorHints
- Object array providing additional (task-specific) information provided by the source of the task redirection. It is expected to contain information that the target task can use to better guide the user to fix any error conditions.
-
getErrors
String[] getErrors()Called by the container wizard if it follows the 'pull' mechanism for error discovery. A task is expected to provide a collection of error messages indicating the error conditions currently existing in the wizard context. If a wizard does not follow the 'pull' mechanism, the task needs to explicitly 'push' the error list to the wizard using the 'displayError()' method.- Returns:
- Array of strings representing any error conditions existing in the context
-