Ajuda para Marcadores

org.eclipse.ui.ide.markerHelp

3.0 (originalmente adicionado na edição 2.0 como org.eclipse.ui.markerHelp)

Este ponto de extensão é utilizado para associar um ID de contexto da ajuda a um "tipo" específico de marcador (um marcador de um determinado tipo ou que tenha determinados valores de atributos).

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


A seguir encontra-se um exemplo de uma extensão de ajuda para marcadores (repare no sub-elemento e no modo como os atributos são utilizados):

 

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

No exemplo anterior, um ID de contexto da ajuda é associado aos marcadores do tipo org.eclipse.ui.examples.readmetool.readmemarker, cujo atributo org.eclipse.ui.examples.readmetool.id tem um valor de 1234.

Depende do programador assegurar que apenas é fornecido um ID único de contexto da ajuda para um determinado marcador. Se forem fornecidos dois ou mais IDs de contexto da ajuda para um determinado tipo de marcador, a área de trabalho não define qual será devolvido. No entanto, a área de trabalho não define que o ID de contexto "mais específico" será sempre devolvido para um determinado marcador. Isto é, um ID de marcador associado a três valores de atributos correspondentes será devolvido antes de um ID de contexto associado a apenas dois.