Οδηγοί περιεχομένου πρόσθετης λειτουργίας
Ταυτότητα:
org.eclipse.pde.ui.pluginContent
Περιγραφή:
Αυτό το σημείο επέκτασης παρέχει συνεισφέροντες οδηγούς που δημιουργούν περιεχόμενο για τα έργα πρόσθετων λειτουργιών PDE. Μετά τη δημιουργία της δήλωσης πρόσθετης λειτουργίας και των αρχείων κλειδιών, οι οδηγοί αυτοί μπορούν να χρησιμοποιηθούν για την προσθήκη περισσότερων αρχείων και επεκτάσεων στην αρχική δομή. Η συνήθης υλοποίηση του οδηγού θα προσθέσει περιεχόμενο που βασίζεται σε ένα παραμετροποιημένο πρότυπο που έχει προσαρμοστεί ανάλογα με τις επιλογές του χρήστη στον οδηγό.
Ο στόχος είναι μια πρόσθετη λειτουργία που κάνει κάτι χρήσιμο αμέσως μετά τη δημιουργία (π.χ. συνεισφέρει μια προβολή, μια λειτουργία επεξεργασίας κλπ.).
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (wizard*)>
<!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 #REQUIRED
category CDATA #IMPLIED
ui-content (true | false) "true"
java (true | false) "true"
rcp (true | false) "false"
pureOSGi (true | false) "false"
requiresActivator (true | false) "false">
- id - Ένα μοναδικό όνομα που θα χρησιμοποιηθεί για τον προσδιορισμό αυτού του οδηγού.
- name - ένα μεταφράσιμο όνομα που θα χρησιμοποιηθεί στην αναπαράσταση του περιβάλλοντος χρήστη αυτού του οδηγού.
- icon - μια σχετική διαδρομή εικονιδίου, που θα χρησιμοποιηθεί για την αναπαράσταση με τη βοήθεια γραφικών του οδηγού.
- class - ένα πλήρες όνομα κλάσης που υλοποιεί την org.eclipse.pde.ui.IPluginContentWizard.
- category - ένα προαιρετικό προσδιοριστικό που μπορεί να χρησιμοποιηθεί για τη συσχέτιση οδηγών περιεχομένου με διαφορετικά έργα προορισμού.
- ui-content - ένας ενδείκτης που υποδεικνύει εάν ο οδηγός θα συνεισφέρει κώδικα με το περιεχόμενο περιβάλλοντος χρήστη. Αυτό ο ενδείκτης θα κρίνει ποια κλάση πρόσθετης λειτουργίας θα επιλέγεται στη συνέχεια (οι πρόσθετες λειτουργίες περιβάλλοντος χρήστη επεκτείνουν την κλάση
AbstractUIPlugin
, ενώ οι πρόσθετες λειτουργίες που δεν σχετίζονται με το περιβάλλον χρήστη επεκτείνουν τη βασική κλάση Plugin
). Εφόσον πολλές συνεισφορές στο Eclipse έχουν περιεχόμενο περιβάλλοντος χρήστη, αυτό το γνώρισμα είναι true
ως προεπιλογή.
- java - ένας ενδείκτης που υποδεικνύει ότι ο οδηγός θα συνεισφέρει περιεχόμενο Java. Εφόσον οι περισσότερες πρόσθετες λειτουργίες του Eclipse έχουν κώδικα Java, το γνώρισμα είναι
true
. Ορίστε το σε false
εάν η πρόσθετη λειτουργία δεν θα έχει κώδικα Java (για παράδειγμα, μόνο αρχεία τεκμηρίωσης).
- rcp - Από την έκδοση 3.1. Ένας λογικός ενδείκτης που υποδεικνύει εάν ο οδηγός συνεισφέρει μια ανεξάρτητη εφαρμογή πλήρους λειτουργίας εμπλουτισμένου πελάτη. Εάν οριστεί σε
true
, ο οδηγός θα εμφανιστεί στον οδηγό δημιουργίας έργου πρόσθετης λειτουργίας μόνο όταν ο χρήστης επιλέξει την "Εφαρμογή εμπλουτισμένου πελάτη".
- pureOSGi - Από την έκδοση 3.2. Ένας λογικός ενδείκτης που υποδεικνύει εάν ο
οδηγός συνεισφέρει μια δέσμη OSGi. Εάν οριστεί σε
true
, ο οδηγός θα
εμφανιστεί στον οδηγό δημιουργίας έργου πρόσθετης λειτουργίας μόνο όταν ο χρήστης
επιλέξει τη δημιουργία δέσμης OSGi.
- requiresActivator - Από την έκδοση 3.2. Ένας λογικός ενδείκτης που υποδεικνύει εάν ο
οδηγός συνεισφέρει μια κλάση activator. Εάν οριστεί σε
true
, ο οδηγός θα
εμφανιστεί στον οδηγό δημιουργίας έργου πρόσθετης λειτουργίας μόνο όταν ο χρήστης
επιλέξει τη δημιουργία κλάσης activator για τον έλεγχο του κύκλου ζωής μιας πρόσθετης
λειτουργίας.
<!ELEMENT description (#PCDATA)>
Σύντομη περιγραφή του οδηγού.
Παραδείγματα:
Ακολουθεί ένα παράδειγμα αυτού του σημείου επέκτασης:
<extension point=
"org.eclipse.pde.ui.pluginContent"
>
<wizard
name=
"Example Plug-in Content Generator"
icon=
"icons/content_wizard.gif"
class=
"com.example.xyz.ContentGeneratorWizard"
id=
"com.example.xyz.ExampleContentGenerator"
>
<description>
Adds a view and a preference page.
</description>
</wizard>
</extension>
Πληροφορίες API:
Οι οδηγοί που συνδέονται με αυτό το σημείο επέκτασης πρέπει να υλοποιούν τη διεπαφή org.eclipse.pde.ui.IPluginContentWizard και αναμένεται να επεκτείνουν τη org.eclipse.jface.wizard.Wizard
.
Παρεχόμενη υλοποίηση:
Το PDE παρέχει API για συνεισφορά οδηγών περιεχομένου με βάση προσαρμόσιμα πρότυπα. Πραγματοποιείται συνεισφορά αριθμού υπαρκτών οδηγών βασιζόμενων σε αυτά τα πρότυπα από το ίδιο το περιβάλλον χρήστη PDE.
Copyright (c) 2004 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.