Pomoc do znacznika

org.eclipse.ui.ide.markerHelp

3.0 (pierwotnie dodany w wersji 2.0 pod nazwą org.eclipse.ui.markerHelp)

Ten punkt rozszerzenia umożliwia powiązanie identyfikatora kontekstu pomocy z określonym rodzajem znacznika (znacznikiem pewnego typu lub o określonych wartościach atrybutów).

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


Poniżej przedstawiono przykład rozszerzenia pomocy znacznika (warto zwrócić uwagę na podelement i sposób użycia atrybutów):

 

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

W powyższym przykładzie identyfikator kontekstu pomocy jest powiązany ze znacznikami typu org.eclipse.ui.examples.readmetool.readmemarker, których atrybut org.eclipse.ui.examples.readmetool.id ma wartość 1234.

Programista powinien zadbać o to, aby dla danego znacznika był podany tylko jeden identyfikator kontekstu pomocy. Jeśli dla danego rodzaju znacznika zostaną podane dwa lub więcej identyfikatorów kontekstu pomocy, środowisko robocze nie określa, który z nich będzie zwracany. Środowisko robocze określa jednak, że dla danego znacznika zawsze zwracany będzie najbardziej charakterystyczny identyfikator kontekstu. Oznacza to, że identyfikator kontekstu powiązany z trzema pasującymi wartościami atrybutów zostanie zwrócony przed identyfikatorem kontekstu powiązanym tylko z dwoma wartościami.