Παραγωγή περιεχομένου βοήθειας
Ταυτότητα:
org.eclipse.help.contentProducer
Από:
3.0
Περιγραφή:
Για την παροχή δυναμικού περιεχομένου βοήθειας, που δημιουργείται κατά το χρόνο εκτέλεσης. Οι
λειτουργίες δημιουργίας περιεχομένου είναι καταχωρημένες κατά πρόσθετη λειτουργία και
λειτουργούν μόνο εντός της εμβέλειας της πρόσθετης λειτουργίας. Για να
χρησιμοποιηθεί εκ νέου μια λειτουργία παραγωγής περιεχομένου σε άλλη πρόσθετη
λειτουργία, πρέπει να χρησιμοποιηθεί το στοιχείο binding
. Με αυτή τη μέθοδο
αποτρέπεται η κατάληψη περιεχομένου από πρόσθετες λειτουργίες το οποίο παράχθηκε για όλες
τις πρόσθετες λειτουργίες. Μέσω της δέσμευσης σε λειτουργία παραγωγής περιεχομένου, μια
πρόσθετη λειτουργία παρέχει σε μια άλλη άδεια ελέγχου περιεχομένου που παράχθηκε για όλα τα
έγγραφα.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (contentProducer | binding)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT contentProducer (producer)>
<!ATTLIST contentProducer
producer CDATA #IMPLIED>
- producer - η κλάση υλοποίησης για την παραγωγή περιεχομένου βοήθειας. Η κλάση αυτή πρέπει να υλοποιεί τη διεπαφή org.eclipse.help.IHelpContentProducer. Το γνώρισμα αυτό μπορεί να παραλείπεται και στη θέση του να παρέχεται το ένθετο στοιχείο producer.
<!ELEMENT producer (parameter*)>
<!ATTLIST producer
class CDATA #REQUIRED>
- class - η κλάση υλοποίησης για την παραγωγή περιεχομένου βοήθειας. Η κλάση αυτή πρέπει να υλοποιεί τη διεπαφή org.eclipse.help.IHelpContentProducer.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - όνομα μιας παραμέτρου που μεταβιβάζεται στην κλάση υλοποίησης
- value - τιμή μιας παραμέτρου που μεταβιβάζεται στην κλάση υλοποίησης
<!ELEMENT binding EMPTY>
<!ATTLIST binding
producerId CDATA #REQUIRED>
- producerId - μοναδικό όνομα λειτουργίας παραγωγής περιεχομένου που
ορίζεται αλλού με τη χρήση του στοιχείου contentProducer. Ο δεσμός επιτρέπει
σε μια πρόσθετη λειτουργία να χρησιμοποιήσει εκ νέου μια λειτουργία παραγωγής
περιεχομένου που έχει καταχωρηθεί σε άλλη πρόσθετη λειτουργία αντί να ορίσει τη δική της.
Παραδείγματα:
Παρακάτω δίνεται ένα
παράδειγμα χρήσης του σημείου επέκτασης λειτουργίας επεξεργασίας παραγωγής:
<extension point=
"org.eclipse.help.contentProducer"
id=
"org.eclipse.myPlugin.myDynamicHelpProducer"
name=
"My Dynamic Help Content"
>
<contentProducer producer=
"org.eclipse.myPlugin.myPackage.Myproducer"
/>
</extension>
Πληροφορίες API:
Η παρεχόμενη κλάση παραγωγής περιεχομένου πρέπει να υλοποιεί τη διεπαφή org.eclipse.help.IHelpContentProducer.
Η διαδικασία παραγωγής είναι υπεύθυνη για την παροχή περιεχομένου για πόρους δυναμικής βοήθειας από μια πρόσθετη λειτουργία. Η μέθοδος παραγωγής περιεχομένου καλείται από τη βοήθεια, για κάθε πόρο βοήθειας που λαμβάνεται από την πρόσθετη λειτουργία.
Παρεχόμενη υλοποίηση:
Καμία. Αν μια πρόσθετη λειτουργία τεκμηρίωσης δεν παρέχει παραγωγή περιεχομένου βοήθειας ή αν μια κλήση προς αυτή δεν έχει αποτέλεσμα, τότε το σύστημα βοήθειας αναζητά doc.zip και το σύστημα αρχείων στη θέση εγκατάστασης της πρόσθετης λειτουργίας για ένα στατικό έγγραφο και εμφανίζει το περιεχόμενό του.
Copyright (c) 2000, 2006 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.