Το προηγούμενο παράδειγμα παρείχε έναν οδηγό για ένα συγκεκριμένο σημείο επέκτασης. Μια άλλη, ίσως πιο κοινή περίπτωση είναι να επιθυμείτε να εκκινήσετε τον οδηγό της πρόσθετης λειτουργίας σας από μια ενέργεια που έχετε ορίσει. (Στην ενότητα Συνεισφορές μενού του πάγκου εργασίας, περιγράψαμε τους τρόπους με τους οποίους μπορείτε να συνεισφέρετε ενέργειες στον πάγκο εργασίας.)
Οι οδηγοί εμφανίζονται στο περιβάλλον χρήστη με την τοποθέτησή τους σε ένα περιεχόμενο πλαίσιο διαλόγου. Γίνεται χειρισμός αυτής της λεπτομέρειας όταν συνεισφέρετε σε μια επέκταση οδηγού. Κατά την εκκίνηση του οδηγού σας, πρέπει να τον εμφανίσετε εσείς αναδιπλώνοντάς τον σε μια WizardDialog.
Για παράδειγμα, η ReadmeCreationWizard μπορεί να γΙνει εκκίνησή της ανεξάρτητα δημιουργώντας ένα πλαίσιο διαλόγου οδηγού και συσχετίζοντάς το με την ReadmeCreationWizard. Το ακόλουθο τμήμα κώδικα δείχνει τον τρόπο με τον οποίο μπορεί να γίνει αυτό από κάποιον εκπρόσωπο ενέργειας. (Η μέθοδος προϋποθέτει ότι γνωρίζουμε τον πάγκο εργασίας και την επιλογή.)
public void run(IAction action) { // Create the wizard ReadmeCreationWizard wizard = new ReadmeCreationWizard(); wizard.init(getWorkbench(), selection); // Create the wizard dialog WizardDialog dialog = new WizardDialog (getWorkbench().getActiveWorkbenchWindow().getShell(),wizard); // Open the wizard dialog dialog.open(); }
Εάν χρειάζεστε να ενσωματώσετε έναν οδηγό οπουδήποτε αλλού στο περιβάλλον χρήστη της πρόσθετης λειτουργίας σας, η διεπαφή IWizardContainer ορίζει το απαραίτητο πρωτόκολλο για τη φιλοξενία ενός οδηγού.