Βοήθεια δείκτη

org.eclipse.ui.ide.markerHelp

3.0 (προστέθηκε αρχικά στην έκδοση 2.0 ως org.eclipse.ui.markerHelp)

Αυτό το σημείο επέκτασης χρησιμοποιείται για τη συσχέτιση μιας ταυτότητας συμφραστικής βοήθειας με ένα καθορισμένο "είδος" δείκτη (έναν δείκτη συγκεκριμένου τύπου ή με καθορισμένες τιμές γνωρισμάτων).

<!ELEMENT extension (markerHelp*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT markerHelp (attribute*)>

<!ATTLIST markerHelp

markerType    CDATA #IMPLIED

helpContextId CDATA #REQUIRED>


<!ELEMENT attribute EMPTY>

<!ATTLIST attribute

name  CDATA #REQUIRED

value CDATA #REQUIRED>


Ακολουθεί ένα παράδειγμα επέκτασης βοήθειας δείκτη (προσέξτε το υπο-στοιχείο και τον τρόπο χρήσης των γνωρισμάτων):

 

<extension point=

"org.eclipse.ui.ide.markerHelp"

>

<markerHelp markerType=

"org.eclipse.ui.examples.readmetool.readmemarker"

helpContextId=

"org.eclipse.ui.examples.readmetool.marker_example1_context"

>

<attribute name=

"org.eclipse.ui.examples.readmetool.id"

value=

"1234"

/>

</markerHelp>

</extension>

Στο παραπάνω παράδειγμα γίνεται συσχέτιση μιας ταυτότητας συμφραστικής βοήθειας με δείκτες του είδους org.eclipse.ui.examples.readmetool.readmemarker, οι οποίοι έχουν τιμή γνωρίσματος org.eclipse.ui.examples.readmetool.id 1234.

Η διασφάλιση της παροχής μόνο μιας ταυτότητα συμφραστικής βοήθειας σε έναν δεδομένο δείκτη, εξαρτάται από τον προγραμματιστή. Αν παρέχονται δύο ή παραπάνω ταυτότητες συμφραστικής βοήθειας για ένα δεδομένο είδος δείκτη, ο πάγκος εργασίας δεν ορίζει ποιά θα επιστραφεί. Ωστόσο, ο πάγκος εργασίας ορίζει πως για έναν δεδομένο δείκτη θα επιστρέφεται πάντα η "πιο συγκεκριμένη" ταυτότητα περιβάλλοντος. Αυτό σημαίνει ότι μια ταυτότητα περιβάλλοντος που έχεισυσχετιστεί με τρεις σύμφωνες τιμές γνωρισμάτων θα επιστραφεί νωρίτερα από ότι μια ταυτότητα περιβάλλοντος που έχει συσχετιστεί μόνο με δύο.