Contribuir con la ayuda de marcador

Ya estamos preparados para ver cómo se añade la ayuda a los marcadores de la herramienta readme. La ayuda de marcador se añade mediante el punto de extensión org.eclipse.ui.markerHelp. Este punto permite que los conectores asocien un ID de contexto de ayuda a un determinado tipo de marcador. 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 distintos:

<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 está definido para el tipo de marcador del readme. Sin embargo, cada contexto de ayuda está asociado a una combinación distinta de valores de atributos. El primer contexto de ayuda de marcador se empleará para los marcadores cuyo atributo id esté establecido en "1234". Los contextos de ayuda están definidos 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 Corp. y otros 2000, 2002.