Merkehjelp

org.eclipse.ui.ide.markerHelp

3.0 (opprinnelig lagt til i utgave 2.0 som org.eclipse.ui.markerHelp)

Dette utvidelsespunktet blir brukt til å knytte en hjelpekontekst-ID til en bestemt type ("kind") merke (et merke av en bestemt type eller med bestemte attributtverdier).

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


Nedenfor finner du et eksempel på en merkehjelputvidelse (legg merke til underelementet og hvordan attributtene blir brukt).

 

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

I eksempelet over er en hjelpekontekst-ID knyttet til merker av typen org.eclipse.ui.examples.readmetool.readmemarker der attributtet org.eclipse.ui.examples.readmetool.id har verdien 1234.

Det er utviklerens ansvar å sikre at det bare oppgis en enkelt hjelpekontekst-ID for et gitt merke. Hvis det er oppgitt to eller flere hjelpekontekst-IDer for en gitt type merke, definerer ikke arbeidsbenken hvilken som blir returnert. Arbeidsbenken definerer imidlertid at den "mest spesifikke" kontekst-IDen alltid skal returneres for et gitt merke. Det vil si at en kontekst-ID som er knyttet til tre samsvarende attributtverdier, blir returnert før en kontekst-ID som bare er knyttet til to.