Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Scout/Concepts/Wizard
Scout |
Wiki Home |
Website |
Download • Git |
Community |
Forums • Blog • Twitter • G+ |
Bugzilla |
Bugzilla |
A wizard presents to the user with a sequence of forms that allow him to work in a process driven approach on a task.
Description
A wizard contains of one or more wizard steps. Each wizard step is typically bound to a form and responsible to start, show and save the form. If a form is started by a wizard step it will be opened inside a wizard container form. The top level system buttons of the form like Ok or Cancel will be hidden since the wizard container form will show wizard buttons instead. Such wizard buttons are Cancel, Next, Previous, Suspend and Finish.
A typical wizard step looks as follows:
@Order(10.0) public class FirstStep extends AbstractWizardStep<FirstForm> { @Override protected String getConfiguredTitle() { return TEXTS.get("First"); } @Override protected void execActivate(int stepKind) throws ProcessingException { FirstForm form = getForm(); if (getForm() == null) { form = new FirstForm(); // Start the form by executing the form handler form.startWizardStep(this, FirstForm.ModifyHandler.class); // Register the form on the step setForm(form); } // Set the form on the wizard // This will automatically display it as inner form of the wizard container form getWizard().setWizardForm(form); } @Override @Order(20.0) protected void execDeactivate(int stepKind) throws ProcessingException { // Save the form if the user clicks next if (stepKind == STEP_NEXT) { FirstForm form = getForm(); if (form != null) { form.doSave(); } } } }
Wizards can be coupled with Workflows on the server.
Screenshot
Properties
Defined with getConfiguredXxxxxx() methods.
Events
Defined with execXxxxxx() methods.