Ayuda de marcadores

Identificador: org.eclipse.ui.markerHelp

A partir del: Release 2.0

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

Códigos XML de configuración:

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

Ejemplos: a continuación figura un ejemplo de extensión de una ayuda de marcadores (observe el subelemento y 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"/>
  </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 (c) 2002, 2003 IBM Corporation y otros. Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a esta distribución, y está disponible en http://www.eclipse.org/legal/cpl-v10.html