Markering - hjælp

org.eclipse.ui.ide.markerHelp

3.0 (oprindeligt tilføjet i release 2.0 som org.eclipse.ui.markerHelp)

Dette udvidelsespunkt bruges til at knytte en hjælpekontekst-id til en bestemt "type" markering (en markering af en bestemt type eller med bestemte attributværdier).

<!ELEMENT extension (markerHelp*)>

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT markerHelp (attribute*)>

<!ATTLIST markerHelp

markerType    CDATA #IMPLIED

helpContextId CDATA #REQUIRED>


<!ELEMENT attribute EMPTY>

<!ATTLIST attribute

navn  CDATA #REQUIRED

value CDATA #REQUIRED>


Her er et eksempel på en udvidelse til markeringshjælp (bemærk underelementet og den måde attributterne bruges på):

 

<udvidelsespunkt=

"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>

I eksemplet ovenfor knyttes en hjælpekontekst-id til markeringer af typen org.eclipse.ui.examples.readmetool.readmemarker, hvis org.eclipse.ui.examples.readmetool.id-attribut har værdien 1234.

Det er op til udvikleren at sikre, at der kun leveres én hjælpekontekst-id for en bestemt markering. Hvis der leveres to eller flere kontekst-id'er for en bestemt type markering, definerer arbejdsbænken ikke, hvilken der returneres. Men arbejdsbænken definerer ikke, at den "mest specifikke" kontekst-id altid returneres for en bestemt markering. Det vil sige, at der returneres en kontekst-id, som er knyttet til tre tilsvarende attributværdier, inden der returneres en kontekst-id, som kun er knyttet til to.