Οδηγοί δημιουργίας

org.eclipse.ui.newWizards

Αυτό το σημείο επέκτασης χρησιμοποιείται για την καταχώρηση επεκτάσεων οδηγών δημιουργίας πόρων. Οι οδηγοί δημιουργίας εμφανίζονται ως επιλογές στο πλαίσιο διαλόγου "Δημιουργία" και συνήθως χρησιμοποιούνται για τη δημιουργία φακέλων και αρχείων.

Στο πλαίσιο διαλόγου "Δημιουργία", οι οδηγοί είναι οργανωμένοι σε κατηγορίες, οι οποίες συνήθως αντικατοπτρίζουν ένα συγκεκριμένο τομέα. Για παράδειγμα, μια πρόσθετη λειτουργία προσανατολισμένη σε Java μπορεί να ορίζει μια κατηγορία που καλείται "Java", η οποία είναι κατάλληλη για οδηγούς δημιουργίας κλάσεων ή πακέτων. Οι κατηγορίες που ορίζονται από μια πρόσθετη λειτουργία μπορούν να λειτουργήσουν ως παραπομπές από άλλες πρόσθετες λειτουργίες, με τη χρήση του γνωρίσματος category. Μη κατηγοριοποιημένοι οδηγοί, καθώς και οδηγοί με μη έγκυρες διαδρομές κατηγορίας, θα καταλήξουν σε μια κατηγορία "Άλλο".

Οι οδηγοί μπορούν προαιρετικά να ορίζουν ένα υποστοιχείο περιγραφής, το οποίο πρέπει να περιέχει ένα σύντομο κείμενο για τον οδηγό.

<!ELEMENT extension (category | wizard | primaryWizard)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>


<!ELEMENT wizard (description? , selection*)>

<!ATTLIST wizard

id                    CDATA #REQUIRED

name                  CDATA #REQUIRED

icon                  CDATA #IMPLIED

category              CDATA #IMPLIED

class                 CDATA #REQUIRED

project               (true | false)

finalPerspective      CDATA #IMPLIED

preferredPerspectives CDATA #IMPLIED

helpHref              CDATA #IMPLIED

descriptionImage      CDATA #IMPLIED

canFinishEarly        (true | false)

hasPages              (true | false) >


<!ELEMENT description (#PCDATA)>

ένα προαιρετικό υποστοιχείο το οποίο περιέχει ένα σύντομο κείμενο που περιγράφει τις ενέργειες που θα πραγματοποιηθούν από τον οδηγό, όταν αυτός ξεκινήσει



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

ένα μέσο που δηλώνει ότι ένας οδηγός είναι "κύριος" στο περιβάλλον χρήστη. Ένας κύριος οδηγός τονίζεται στο πλαίσιο διαλόγου οδηγού δημιουργίας. Θα πρέπει να σημειωθεί ότι το στοιχείο αυτό δεν προορίζεται για χρήση από προγραμματιστές πρόσθετων λειτουργιών! Το στοιχείο αυτό υπάρχει έτσι ώστε οι διαχειριστές προϊόντων να μπορούν να τονίσουν ένα σύνολο οδηγών για τα προϊόντα τους.



Παρακάτω δίνεται ένα παράδειγμα ρυθμίσεων οδηγού δημιουργίας:

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"XYZ Wizards"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Web Wizards"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"XYZ artifact"

category=

"com.xyz.XYZ/com.xyz.XYZ.Web"

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<description>

Create a simple XYZ artifact and set initial content

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Η τιμή του γνωρίσματος class πρέπει να αντιστοιχεί σε μια κλάση η οποία υλοποιεί την org.eclipse.ui.INewWizard. Αν ένας οδηγός δημιουργείται από τον οδηγό δημιουργίας, τότε θα εισάγεται στον υπάρχοντα οδηγό. Εάν ένας οδηγός ξεκινά ως συντόμευση (από την επιλογή "Δημιουργία" του μενού "Αρχείο" ή ένα κουμπί της γραμμής εργαλείων), τότε θα εμφανίζεται ανεξάρτητα, ως ένα ξεχωριστό πλαίσιο διαλόγου.

Ο πάγκος εργασίας διαθέτει οδηγούς για τη δημιουργία κενών πόρων των ακόλουθων ειδών: έργο, φάκελος και αρχείο. Οι οδηγοί αυτοί καταχωρούνται με τη χρήση του ίδιου μηχανισμού που περιγράφεται και παραπάνω. Ενδέχεται επίσης να εμφανίζονται επιπλέον οδηγοί, ανάλογα με την συγκεκριμένη εγκατάσταση πλατφόρμας.