Οδηγοί δημιουργίας
Ταυτότητα:
org.eclipse.ui.newWizards
Περιγραφή:
Αυτό το σημείο επέκτασης χρησιμοποιείται για την καταχώρηση επεκτάσεων οδηγών δημιουργίας πόρων. Οι οδηγοί δημιουργίας εμφανίζονται ως επιλογές στο πλαίσιο διαλόγου "Δημιουργία" και συνήθως χρησιμοποιούνται για τη δημιουργία φακέλων και αρχείων.
Στο πλαίσιο διαλόγου "Δημιουργία", οι οδηγοί είναι οργανωμένοι σε κατηγορίες, οι οποίες συνήθως αντικατοπτρίζουν ένα συγκεκριμένο τομέα. Για παράδειγμα, μια πρόσθετη λειτουργία προσανατολισμένη σε Java μπορεί να ορίζει μια κατηγορία που καλείται "Java", η οποία είναι κατάλληλη για οδηγούς δημιουργίας κλάσεων ή πακέτων. Οι κατηγορίες που ορίζονται από μια πρόσθετη λειτουργία μπορούν να λειτουργήσουν ως παραπομπές από άλλες πρόσθετες λειτουργίες, με τη χρήση του γνωρίσματος category. Μη κατηγοριοποιημένοι οδηγοί, καθώς και οδηγοί με μη έγκυρες διαδρομές κατηγορίας, θα καταλήξουν σε μια κατηγορία "Άλλο".
Οι οδηγοί μπορούν προαιρετικά να ορίζουν ένα υποστοιχείο περιγραφής, το οποίο πρέπει να περιέχει ένα σύντομο κείμενο για τον οδηγό.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (category | wizard | primaryWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρως προσδιορισμένη ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - ένα μοναδικό όνομα που μπορεί να χρησιμοποιηθεί για τον ορισμό αυτής της
κατηγορίας
- name - ένα μεταφράσιμο όνομα της κατηγορίας που θα χρησιμοποιηθεί στο πλαίσιο διαλόγου
- parentCategory - μια διαδρομή προς άλλη κατηγορία εάν αυτή η κατηγορία πρέπει να προστεθεί ως θυγατρική
<!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) >
- id - ένα μοναδικό όνομα που μπορεί να χρησιμοποιηθεί για τον προσδιορισμό αυτού του οδηγού
- name - ένα μεταφράσιμο όνομα του οδηγού που θα χρησιμοποιηθεί στο πλαίσιο διαλόγου
- icon - μια σχετική διαδρομή εικονιδίου, που θα χρησιμοποιηθεί μαζί με το όνομα, για την εμφάνιση του οδηγού ως μία από τις επιλογές του πλαισίου διαλόγου δημιουργίας.
- category - μια οριοθετημένη με κάθετο ('/') διαδρομή ταυτοτήτων κατηγοριών.
Κάθε στοιχείο της διαδρομής πρέπει να αναπαριστά μια έγκυρη ταυτότητα κατηγορίας που έχει
προηγουμένως οριστεί από αυτή ή άλλη πρόσθετη λειτουργία. Εάν παραλειφθεί, ο οδηγός θα προστεθεί στην κατηγορία "Άλλο".
- class - ένα πλήρες όνομα της κλάσης Java που υλοποιεί την org.eclipse.team.ui.INewWizard.
- project - ένα προαιρετικό γνώρισμα που υποδεικνύει τον οδηγό που θα δημιουργήσει έναν πόρο IProject.
Επίσης εμφανίζει τον οδηγό ως μια επιλογή του πλαισίου διαλόγου δημιουργίας έργου.
- finalPerspective - ένα προαιρετικό γνώρισμα το οποίο προσδιορίζει την προοπτική που ενεργοποιείται, όταν ολοκληρώνεται η δημιουργία πόρου IProject.
- preferredPerspectives - ένα προαιρετικό γνώρισμα που προσδιορίζει μια λίστα ταυτοτήτων προοπτικών, που διαχωρίζονται με κόμμα. Εάν η τρέχουσα προοπτική βρίσκεται στη λίστα αυτή, τότε κατά την ολοκλήρωση της δημιουργίας πόρου IProject, δεν πραγματοποιείται ενεργοποίηση προοπτικής.
- helpHref - μια διεύθυνση url βοήθειας όπου περιγράφεται αναλυτικά ο οδηγός αυτός.
Από την έκδοση 3.0.
- descriptionImage - μια μεγαλύτερη εικόνα που βοηθά στην περιγραφή του οδηγού αυτού.
Από την έκδοση 3.0.
- canFinishEarly - εάν ο οδηγός έχει τη δυνατότητα ολοκλήρωσης χωρίς να εμφανίζει σελίδες στον χρήστη.
- hasPages - εάν ο οδηγός παρέχει κάποιες σελίδες.
<!ELEMENT description (#PCDATA)>
ένα προαιρετικό υποστοιχείο το οποίο περιέχει ένα σύντομο κείμενο που περιγράφει τις ενέργειες που θα πραγματοποιηθούν από τον οδηγό, όταν αυτός ξεκινήσει
<!ELEMENT selection EMPTY>
<!ATTLIST selection
class CDATA #REQUIRED
name CDATA #IMPLIED>
- class - ένα πλήρες όνομα κλάσης. Αν κάθε αντικείμενο στην επιλογή του πάγκου εργασίας υλοποιεί αυτή τη διεπαφή, η επιλογή μεταβιβάζεται στον οδηγό. Σε αντίθετη περίπτωση, μεταβιβάζεται μια κενή επιλογή.
- name - ένα προαιρετικό φίλτρο ονομάτων. Κάθε αντικείμενο στην επιλογή του πάγκου εργασίας πρέπει να συμφωνεί με το φίλτρο ονομάτων για να μπορεί να μεταβιβάζεται στον οδηγό.
<!ELEMENT primaryWizard EMPTY>
<!ATTLIST primaryWizard
id CDATA #REQUIRED>
ένα μέσο που δηλώνει ότι ένας οδηγός είναι "κύριος" στο περιβάλλον χρήστη. Ένας κύριος οδηγός τονίζεται στο πλαίσιο διαλόγου οδηγού δημιουργίας. Θα πρέπει να σημειωθεί ότι το στοιχείο αυτό δεν προορίζεται για χρήση από προγραμματιστές πρόσθετων λειτουργιών! Το στοιχείο αυτό υπάρχει έτσι ώστε οι διαχειριστές προϊόντων να μπορούν να τονίσουν ένα σύνολο οδηγών για τα προϊόντα τους.
- id - η ταυτότητα ενός οδηγού που θα πρέπει να καταστεί κύριος.
Παραδείγματα:
Παρακάτω δίνεται ένα παράδειγμα ρυθμίσεων οδηγού δημιουργίας:
<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>
Πληροφορίες API:
Η τιμή του γνωρίσματος class πρέπει να αντιστοιχεί σε μια κλάση η οποία υλοποιεί την org.eclipse.ui.INewWizard.
Αν ένας οδηγός δημιουργείται από τον οδηγό δημιουργίας, τότε θα εισάγεται στον υπάρχοντα οδηγό.
Εάν ένας οδηγός ξεκινά ως συντόμευση (από την επιλογή "Δημιουργία" του μενού "Αρχείο" ή ένα κουμπί της γραμμής εργαλείων), τότε θα εμφανίζεται ανεξάρτητα, ως ένα ξεχωριστό πλαίσιο διαλόγου.
Παρεχόμενη υλοποίηση:
Ο πάγκος εργασίας διαθέτει οδηγούς για τη δημιουργία κενών πόρων των ακόλουθων ειδών: έργο, φάκελος και αρχείο. Οι οδηγοί αυτοί καταχωρούνται με τη χρήση του ίδιου μηχανισμού που περιγράφεται και παραπάνω.
Ενδέχεται επίσης να εμφανίζονται επιπλέον οδηγοί, ανάλογα με την συγκεκριμένη εγκατάσταση πλατφόρμας.
Copyright (c) 2002, 2005 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα
συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας
χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και
διατίθεται στην ακόλουθη διεύθυνση:
http://www.eclipse.org/legal/epl-v10.html.