RCPDialoge

Ein Dialog besteht aus einer Dialog Seite (DialogPage). Man kann eigene DialogPages erzeugen in den man von der Klasse AbstractDialogPage ableitet, oder man leitet von der Klasse FormBackedDialogPage, welche ein Formular benutzt. Man kann DialogPages gruppieren, indem man eine CompositeDialogPage nutzt, welche folgende Implementierung besitzt: TabbedDialogPage

TODO: example of FormBackedDialogPage TODO: example of TabbedDialogPage and TreeCompositeDialogPage + screenshots TODO: example of AbstractDialogPage implementation

Anwendungs Dialoge

Anwendungsdialoge sind einfache Dialoge. Sie können genutzt werden um dem Nutzer Informationen anzuziegen, oder vom Nutzer Eingaben entgegen zu nehmen.

Bestätigungs Dialoge

Ein Bestätigungsdialog wird genutzt, um Bestätigungen vom Nutzer zu erfragen. Dazu muss man von der Klasse ConfirmationDialog ableiten und die Methode onConfirm implementieren.

ConfirmationDialog dialog = new ConfirmationDialog() 
  {
   protected void onConfirm() 
    {
     // insert the code to execute on confirmation
    };
  }

dialog.setTitle("Confirmation");
dialog.setConfirmationMessage("Are you sure you want to do this?");
dialog.showDialog();

TODO: insert image here

Anwendungs Eingabe Dialoge

TODO: insert image here

Anwendungs Dialog mit Titel

Ein Anwendungsdialog mit Titel besitzt oben einen Titelbereich , welcher z.B. eine Beschreibung des Dialogs oder eine Fehlermeldung enthalten kann.

TODO: insert image here

Wizard Framework

Ein Wizard verwaltet eine Liste von WizardPages mit einem Mechanismus, um diese in einer wohl definierten Reihenfolge abzuarbeiten, normalerweise durch klicken auf einen "Weiter" Button. Typische Wizard Funktionen werden unterstützt, z.B. ein Beenden Button, sobald ausreichen Daten gesammelt wurden, ausgegraute Buttons, falls noch Eingaben fehlen, etc. etc. Ein Wizard wird in einem WizardContainer betrieben.

Wizard Page

Eine WizardPage (Interface) ist eine spezialisierte DialogPage, welche daüber informiert ist, dass sie ein Teil eines Wizards ist. Zur Einfachheit wird eine AbstractWizardPage zur Verfügung gestellt.

Pages sollten einem Wizard durch mehrfachen Aufruf der Methode addPage() hinzugefügt werden. Es ist die normale Vorgehensweise, die Methode Wizard.addPage() zu überschreiben. AbstractWizards stellen ausserdem eine Methode addForm() zur Verfügung, welche ein Formular in eine FormBackedWizardPage einbindet.

Die Seiten werden in der Reihenfolge angezeigt, in der sie hinzugefügt wurden.

Wizard Container

WizardContainer ist ein Interface, welches von Containern implementiert wird, welche einen Wizard hosten können. Zur Zeit gibt es hierfür nur den WizardDialog (ein modaler Dialog, der den Wizard rendert). Durch die Implementierung dieses Interfaces können Wizard überall itnegriert werden.

Wizard Dialog

Resources

Falls der Wizard eine nicht leere ID besitzt, werden Resourcen unter dem Schlüssel wizardId.pageId.objectId gesucht, falls nicht, unter pageId.objectId

SetupWizard

Das Paket org.springframework.richclient.application.setup enthält Klassen, welche einen Wizard zum Annehmen einer Lizenz implementieren. Dies ist ein gutes Beispiel für die Implementierung eines Wizards.

Dynamic Wizard Page Sequence

From the forum:

Question	Answer
Is it possible to have dynamic WizardPages in a Wizard?	Register all possible wizard pages with your Wizard implementation and then use the page level getNextPage() and getPreviousPage() methods to customize the page ordering.