Οδηγοί επέκτασης
Ταυτότητα:
org.eclipse.pde.ui.newExtension
Περιγραφή:
Αυτό το σημείο επέκτασης πρέπει να χρησιμοποιείται για τη συνεισφορά οδηγών που θα χρησιμοποιηθούν για τη δημιουργία και τροποποίηση νέων επεκτάσεων σε λειτουργία επεξεργασίας δήλωσης πρόσθετης λειτουργίας PDE. Οι οδηγοί μπορούν να δημιουργήσουν μία ή περισσότερες επεκτάσεις ταυτόχρονα, καθώς και τον απαραίτητο κώδικα για την υλοποίηση των επεκτάσεων αυτών. Εάν ένας οδηγός από συνεισφορά δημιουργηθεί ειδικά για ένα συγκεκριμένο σημείο επέκτασης, συνιστάται επίσης η καταχώρηση ενός αντίστοιχου οδηγού λειτουργίας επεξεργασίας. Αυτός ο οδηγός θα χρησιμοποιηθεί για την τροποποίηση του σημείου επέκτασης στη λειτουργία επεξεργασίας δήλωσης αφού δημιουργηθεί στο αρχείο δήλωσης.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (wizard | category | editorWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρως προσδιορισμένη ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT wizard (description?)>>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #IMPLIED
availableAsShortcut (true | false)
category CDATA #IMPLIED
template CDATA #IMPLIED>
ένας οδηγός που μπορεί να χρησιμοποιηθεί για τη δημιουργία μιας νέας επέκτασης μέσα από τη λειτουργία επεξεργασίας δήλωσης πρόσθετης λειτουργίας.
- id - Ένα μοναδικό όνομα που θα χρησιμοποιηθεί για τον προσδιορισμό αυτού του οδηγού.
- name - ένα μεταφράσιμο όνομα που θα χρησιμοποιηθεί στην αναπαράσταση του περιβάλλοντος χρήστη αυτού του οδηγού.
- icon - μια σχετική διαδρομή εικονιδίου, που θα χρησιμοποιηθεί για την αναπαράσταση με τη βοήθεια γραφικών του οδηγού.
- class - ένα πλήρες όνομα κλάσης που υλοποιεί τη διεπαφή org.eclipse.pde.ui.IExtensionWizard. Το γνώρισμα είναι αμοιβαία αποκλειόμενο με το γνώρισμα
template
.
- availableAsShortcut - Εάν είναι true, θα εμφανιστεί αυτός ο οδηγός στο μενού συντομεύσεων στη γραμμή μενού και τη γραμμή εργαλείων.
- category - μια προαιρετική ταυτότητα που καθιστά τον οδηγό μέλος μιας προηγούμενα καθορισμένης κατηγορίας. Εάν η κατηγορία είναι ιεραρχική, θα πρέπει να προσδιοριστεί η πλήρης διαδρομή στο γονικό κατάλογο με χρήση '/' ως οριοθέτη.
- template - μια ταυτότητα προτύπου που δηλώνεται αλλού με χρήση του σημείου επέκτασης
org.eclipse.pde.ui.templates
. Εάν ορίζεται, το πρότυπο με την καθορισμένη ταυτότητα θα εντοπιστεί και θα δημιουργηθεί ο οδηγός επέκτασης με χρήση του προτύπου. Το γνώρισμα είναι αμοιβαία αποκλειόμενο με το γνώρισμα class
.
<!ELEMENT editorWizard (description?)>>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
ένας οδηγός που μπορεί να χρησιμοποιηθεί για την τροποποίηση μιας υπάρχουσας επέκτασης μέσα από τη λειτουργία επεξεργασίας δήλωσης πρόσθετης λειτουργίας.
- id - Ένα μοναδικό όνομα που θα χρησιμοποιηθεί για τον προσδιορισμό αυτού του οδηγού.
- name - ένα μεταφράσιμο όνομα που θα χρησιμοποιηθεί στην αναπαράσταση του περιβάλλοντος χρήστη αυτού του οδηγού.
- icon - μια σχετική διαδρομή εικονιδίου, που θα χρησιμοποιηθεί για την αναπαράσταση με τη βοήθεια γραφικών του οδηγού.
- class - ένα πλήρες όνομα κλάσης που υλοποιεί τη διεπαφή org.eclipse.pde.uui.IExtensionEditorWizard.
- point - μια πλήρης ταυτότητα του σημείου επέκτασης που ο συγκεκριμένος οδηγός μπορεί να τροποποιήσει.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - ένα μοναδικό όνομα που θα χρησιμοποιηθεί για παραπομπή σε αυτή την κατηγορία
- name - ένα μεταφράσιμο όνομα που θα χρησιμοποιηθεί στην αναπαράσταση του περιβάλλοντος χρήστη αυτής της κατηγορίας.
- parentCategory - ένα προαιρετικό γνώρισμα που μπορεί να χρησιμοποιηθεί για τη δημιουργία ιεραρχίας κατηγορίας
<!ELEMENT description (#PCDATA)>
Μια σύντομη περιγραφή του οδηγού.
Παραδείγματα:
Ακολουθεί ένα παράδειγμα του σημείου επέκτασης:
<extension
point=
"org.eclipse.pde.ui.newExtension"
>
<category
name=
"Custom Extensions"
id=
"custom"
>
</category>
<wizard
availableAsShortcut=
"true"
name=
"Simple Java Editor Extension"
icon=
"icons/java_edit.gif"
category=
"generic"
class=
"com.example.xyz.SimpleJavaEditorExtension"
id=
"com.example.xyz.simple"
>
<description>
This wizard creates a simple Java editor with
all the required classes and manifest markup.
</description>
</wizard>
</extension>
Πληροφορίες API:
Αυτό το σημείο επέκτασης απαιτεί μια κλάση να υλοποιεί τη διεπαφή org.eclipse.pde.ui.IExtensionWizard.
Παρεχόμενη υλοποίηση:
Το PDE παρέχει ένα γενικό οδηγό που δημιουργεί σημεία επέκτασης με βάση τις πληροφορίες σχήματος σημείου επέκτασης. Επιπρόσθετα, όλα τα καταχωρημένα πρότυπα που χρησιμοποιούν το σημείο επέκτασης org.eclipse.pde.ui.templates
στο περιβάλλον χρήστη PDE δεσμεύονται επίσης ως μεμονωμένοι οδηγοί επέκτασης.
Copyright (c) 2004 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.