Aportar ayuda de marcador

Ahora estamos preparados para examinar cómo se añade ayuda a los marcadores de la herramienta readme.  La adición de ayuda de marcador se realiza mediante el punto de extensión org.eclipse.ui.markerHelp.  Este punto de extensión permite a los conectores asociar un ID de contexto de ayuda con un tipo de marcador determinado.  El marcador puede estar calificado solo por su tipo o, además, por el valor de uno o varios de sus atributos.   La herramienta readme declara varios contextos de ayuda diferentes:

<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> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example2_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> 
   </markerHelp> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example3_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> 
      <attribute name="org.eclipse.ui.examples.readmetool.department" value= "infra"/> 
   </markerHelp> 
   ...

Cada contexto de ayuda de marcador se define para el tipo de marcador de readme.  Sin embargo, cada contexto de ayuda está asociado con una combinación de valores de atributo diferente.  El primer contexto de ayuda de marcador se utilizará para los marcadores cuyo atributo id esté establecido en "1234".  Los contextos de ayuda se definen en el archivo HelpContexts.xml del conector:

<context id="marker_example1_context" >
	<description><b>Ayuda</b>
del ejemplo 1 de marcador del readme id = 1234 </description>
</context>

Cuando seleccionemos un marcador del readme con el id="1234" y seleccionemos la ayuda con la tecla F1, veremos nuestra descripción de la ayuda.

Lista de tareas con ayuda de marcador

Copyright IBM Corporation y otros 2000, 2003.