Ayuda de marcadores

Identificador: org.eclipse.ui.markerHelp

Descripción: 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).

A partir del: Release 2.0

Códigos XML de configuración:

   <!ELEMENT markerHelp (attribute)*>
   <!ATTLIST markerHelp
      markerType       CDATA #OPTIONAL
      helpContextId    CDATA #REQUIRED
   >

   <!ELEMENT attribute EMPTY>
   <!ATTLIST attribute
      name         CDATA #REQUIRED
      value        CDATA #REQUIRED
   > Ejemplos:

A continuación figura un ejemplo de extensión de una ayuda de marcadores (fíjese en el subelemento y en la manera de utilizar los atributos):

<extension point="org.eclipse.ui.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">
      </attribute>
   </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.

Información sobre las API: el desarrollador es quien tiene que 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.

Copyright IBM Corporation y otros 2000, 2002.