Markierungshilfe

org.eclipse.ui.ide.markerHelp

3.0 (ursprünglich hinzugefügt in Release 2.0 als 'org.eclipse.ui.markerHelp')

Dieser Erweiterungspunkt dient zur Zuordnung einer Hilfekontextkennung zu einer bestimmten "Art" von Markierung (eine Markierung eines bestimmten Typs oder mit bestimmten Attributwerten).

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


Im Folgenden ist ein Beispiel für eine Erweiterung einer Markierungshilfe angegeben (bitte achten Sie auf das Unterelement und darauf, wie Attribute verwendet werden):

 

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

Im dargestellten Beispiel werden einer Hilfekontextkennung Markierungen vom Typ "org.eclipse.ui.examples.readmetool.readmemarker" zugeordnet, deren Attribut "org.eclipse.ui.examples.readmetool.id" einen Wert von 1234 hat.

Es liegt im Ermessen des Entwicklers, sicherzustellen, dass nur eine einzige Hilfekontextkennung für eine bestimmte Markierung zur Verfügung gestellt wird. Werden für eine bestimmte Art von Markierung zwei oder mehr Hilfekontextkennungen zur Verfügung gestellt, definiert die Workbench nicht, welche der Kennungen zurückgegeben wird. Die Workbench definiert allerdings, dass für eine bestimmte Markierung immer die "spezifischste" Kontextkennung zurückgegeben wird. Beispielsweise würde eine Kontextkennung mit drei zugeordneten übereinstimmenden Attributen vor einer Kontextkennung mit nur zwei zugeordneten Attributen zurückgegeben.