Επέκταση στοιχείου φύλλου υποδείξεων

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>


<!ELEMENT itemExtension EMPTY>

<!ATTLIST itemExtension

itemAttribute CDATA #REQUIRED

class         CDATA #REQUIRED>

Χρησιμοποιήστε αυτή την επέκταση για την προσθήκη στοιχείων σε βήματα φύλλου υποδείξεων. Μπορείτε να χρησιμοποιήσετε μόνο αυτό το σημείο επέκτασης για την προσθήκη εικονιδίων κα κουμπιών (επί του παρόντος, δίπλα στο εικονίδιο βοήθειας) για ένα βήμα στο φύλλο υποδείξεων. Προσδιορίζεται το όνομα γνωρίσματος που θα εισάγετε στο προσδιοριστικό στοιχείου φύλλου υποδείξεων. Μπορείτε να προσδιορίσετε μια κλάση που θα χειρίζεται την ανάλυση της τιμής γνωρίσματος από το αρχείο περιεχομένου του φύλλου υποδείξεων όταν φορτώνεται το φύλλο υποδείξεων. Η τιμή γνωρίσματος πρέπει να είναι μια σειρά χαρακτήρων. Η προσδιορισμένη κλάση πρέπει να θέσει σε υποκλάση org.eclipse.ui.cheatsheets.AbstractItemExtensionElement. Αφού αναλυθεί και φορτωθεί το αρχείο περιεχομένου του φύλλου υποδείξεων, η καθορισμένη κλάση στο σημείο επέκτασης καλείται ξανά μέσω της διεπαφής για την προσθήκη γραφικών ή κουμπιών στο βήμα του φύλλου υποδείξεων (επί του παρόντος, δίπλα στο κουμπί βοήθειας).



Παρακάτω δίνεται ένα παράδειγμα υλοποίησης αυτού του σημείου επέκτασης:

<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 ως το εικονίδιο για το νέο κουμπί.

Δείτε τις πληροφορίες Javadoc για org.eclipse.ui.cheatsheets.AbstractItemExtensionElement για λεπτομέρειες API.

Δεν παρέχεται υλοποίηση αυτή τη φορά.