Ayuda de marcadores

org.eclipse.ui.ide.markerHelp

3.0 (originariamente añadido en el release 2.0 como org.eclipse.ui.markerHelp)

Este punto de extensión permite asociar un ID de contexto de ayuda a una "especie" concreta de marcador (un marcador de un tipo determinado o que tiene 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 continuación figura un ejemplo de extensión de ayuda de marcador (observe el subelemento y la manera de utilizar los atributos):

 

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

En el ejemplo anterior, hay un ID de contexto de ayuda asociado a los marcadores de tipo org.eclipse.ui.examples.readmetool.readmemarker cuyo atributo org.eclipse.ui.examples.readmetool.id tiene el valor 1234.

El desarrollador es el responsable de garantizar que únicamente se suministre un solo ID de contexto de ayuda para un marcador dado. Si se suministran dos o más ID de contexto de ayuda para un determinado tipo de marcador, el entorno de trabajo no define cuál de ellos se devolverá. Sin embargo, el entorno de trabajo sí define que se devuelva siempre el ID de contexto que sea "más específico" del marcador en cuestión. Por ejemplo, se devolvería un ID de contexto asociado que tuviera tres valores de atributo coincidentes antes que un ID de contexto asociado que tan solo tuviera dos.