Επέκταση στοιχείου φύλλου υποδείξεων
Ταυτότητα:
org.eclipse.ui.cheatsheets.cheatSheetItemExtension
Από:
3.0
Περιγραφή:
Αυτό το σημείο επέκταση πρέπει να χρησιμοποιείται όταν πρέπει να προστεθεί κουμπί σε ένα βήμα στο φύλλο υποδείξεων.
Μπορείτε να βάλετε ένα νέο γνώρισμα στο προσδιοριστικό "item" στο αρχείο περιεχομένου φύλλου υποδείξεων και όταν αυτή η τιμή αναγνωσθεί από το πλαίσιο του φύλλου υποδείξεων, θα ελέγξει εάν υπάρχει καταχωρημένη κλάση μέσω αυτού του σημείου επέκτασης που θα διαχειριστεί το γνώρισμα. Το όνομα γνωρίσματος που βρίσκεται στο φύλλο υποδείξεων αντιστοιχίζεται ως προς όλες τις τιμές που βρίσκονται στο γνώρισμα "itemAttribute" όλων των καταχωρημένων υλοποιήσεων του σημείου cheatsheetItemExtension. Εάν υπάρχει αντιστοίχιση, η καθορισμένη κλάση για το χειρισμό αυτού του γνωρίσματος στοιχείου φορτώνεται από το πλαίσιο φύλλου υποδείξεων και καλείται για το χειρισμό του γνωρίσματος που καθορίζεται στο αρχείο περιεχομένου του φύλλου υποδείξεων.
Μετά την ανάλυση της τιμής του γνωρίσματος στοιχείου, η κλάση παραμένει διαθέσιμη στο πλαίσιο του φύλλου υποδείξεων. Όταν το στοιχείο αποδοθεί για την προβολή φύλλου υποδείξεων, η κλάση καλείται ξανά για το χειρισμό της προσθήκης συστατικών στοιχείων σε ένα "Σύνθετο στοιχείο". Τα στοιχεία που προστίθενται σε αυτό το σύνθετο στοιχείο εμφανίζονται στο βήμα του φύλλου υποδείξεων (επί του παρόντος, δίπλα στο εικονίδιο βοήθειας). Εμφανίζεται μόνο για το βήμα που περιγράφεται από το προσδιοριστικό "item" που το γνώρισμα εμφάνισε στο αρχείο περιεχομένου του φύλλου υποδείξεων.
Η προτεινόμενη χρήση αυτού του σημείου επέκτασης είναι η προσθήκη ενός μικρού κουμπιού (16x16) με γραφικό, το οποίο ανοίγει ένα πλαίσιο διαλόγου όταν πατηθεί.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (itemExtension)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρως προσδιορισμένη ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT itemExtension EMPTY>
<!ATTLIST itemExtension
itemAttribute CDATA #REQUIRED
class CDATA #REQUIRED>
Χρησιμοποιήστε αυτή την επέκταση για την προσθήκη στοιχείων σε βήματα φύλλου υποδείξεων. Μπορείτε να χρησιμοποιήσετε μόνο αυτό το σημείο επέκτασης για την προσθήκη εικονιδίων κα κουμπιών (επί του παρόντος, δίπλα στο εικονίδιο βοήθειας) για ένα βήμα στο φύλλο υποδείξεων.
Προσδιορίζεται το όνομα γνωρίσματος που θα εισάγετε στο προσδιοριστικό στοιχείου φύλλου υποδείξεων. Μπορείτε να προσδιορίσετε μια κλάση που θα χειρίζεται την ανάλυση της τιμής γνωρίσματος από το αρχείο περιεχομένου του φύλλου υποδείξεων όταν φορτώνεται το φύλλο υποδείξεων. Η τιμή γνωρίσματος πρέπει να είναι μια σειρά χαρακτήρων. Η προσδιορισμένη κλάση πρέπει να θέσει σε υποκλάση org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
. Αφού αναλυθεί και φορτωθεί το αρχείο περιεχομένου του φύλλου υποδείξεων, η καθορισμένη κλάση στο σημείο επέκτασης καλείται ξανά μέσω της διεπαφής για την προσθήκη γραφικών ή κουμπιών στο βήμα του φύλλου υποδείξεων (επί του παρόντος, δίπλα στο κουμπί βοήθειας).
- itemAttribute - Αυτή η τιμή γνωρίσματος πρέπει να είναι η τιμή σειράς χαρακτήρων ενός ονόματος γνωρίσματος που τοποθετείται σε ένα προσδιοριστικό στοιχείου στο αρχείο περιεχομένου του φύλλου υποδείξεων. Εάν αυτή η σειρά χαρακτήρων γνωρίσματος αντιστοιχεί με ένα γνώρισμα που έχει αναλυθεί από το προσδιοριστικό στοιχείου στο αρχείο αποθήκευσης φύλλου υποδείξεων, η καθορισμένη κλάση θα φορτωθεί και θα κληθεί να αναλύσει την πλήρη τιμή του γνωρίσματος χρησιμοποιώντας τις προδιαγραφές w3 DOM. Θα κληθεί στη συνέχεια για την προσθήκη στοιχείων ελέγχου σε ένα "Σύνθετο στοιχείο" και τα συστατικά στοιχεί (συνήθως γραφικά ή κουμπιά) που προστέθηκαν θα εμφανιστούν στο βήμα του φύλλου υποδείξεων για το προσδιορισμένο στοιχείο (επί του παρόντος, δίπλα στο εικονίδιο βοήθειας για το βήμα αυτό).
- class - το πλήρες όνομα κλάσης της κλάσης που αποτελεί υποκλάση
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
για το χειρισμό άγνωστων γνωρισμάτων στο αρχείο περιεχομένου φύλλου υποδείξεων και επεκτείνει τα βήματα στο φύλλο υποδείξεων. Η κλάση πρέπει να είναι δημόσια και να έχει μια δημόσια λειτουργία κατασκευής με 1 όρισμα που αποδέχεται το όνομα γνωρίσματος (ένα String
).
Παραδείγματα:
Παρακάτω δίνεται ένα παράδειγμα υλοποίησης αυτού του σημείου επέκτασης:
<extension point=
"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"
>
<itemExtension
itemAttribute=
"xyzButton"
class=
"com.example.HandleParsingAndAddButton"
>
</itemExtension>
</extension>
Κι εδώ είναι το γνώρισμα στοιχείου για την επέκταση αυτή:
<item title=
"XYZ Title"
xyzButton=
"/icon/button.gif"
/>
Σημειώστε ότι η τιμή του γνωρίσματος στο προσδιοριστικό στοιχείου μπορεί να είναι ΟΤΙΔΗΠΟΤΕ. Μπορεί να είναι οτιδήποτε διότι η κλάση που αναλύει αυτό το γνώρισμα είναι η κλάση HandleParsingAndAddButton, που σε αυτό το παράδειγμα αναλύει μια σειρά χαρακτήρων /icon/button.gif από το γνώρισμα. Στη συνέχεια θα χρησιμοποιήσει αυτές τις πληροφορίες για να φορτώσει το gif ως το εικονίδιο για το νέο κουμπί.
Πληροφορίες API:
Δείτε τις πληροφορίες Javadoc για org.eclipse.ui.cheatsheets.AbstractItemExtensionElement για λεπτομέρειες API.
Παρεχόμενη υλοποίηση:
Δεν παρέχεται υλοποίηση αυτή τη φορά.
Copyright (c) 2004, 2006 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.