Contribuir com ajuda de marcador

Agora estamos preparados para ver como se adiciona ajuda aos marcadores da ferramenta readme.  A adição de ajuda de marcador processa-se com o ponto de extensão org.eclipse.ui.ide.markerHelp.  Este ponto de extensão permite aos plug-ins associarem um ID de contexto de ajuda a determinado tipo de marcador.  O marcador pode ser qualificado somente por tipo de marcador ou mais qualificado pelo valor de um ou mais dos seus atributos. A ferramenta readme declara vários contextos de ajuda diferentes:

<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> 
   <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 ajuda de marcador é definido para o tipo de marcador readme.   Todavia, cada contexto de ajuda está associado a uma combinação diferente de valores de atributo.  O primeiro contexto de ajuda de marcador será usado para marcadores cujo atributo id esteja definido como "1234". Os contextos de ajuda estão definidos no ficheiro HelpContexts.xml do plug-in:

<context id="contexto_marcador_exemplo1" >
	<description>Exemplo 1 do marcador readme<b>Help</b> id = 1234 </description>
</context>

Naturalmente que, quando seleccionarmos um marcador readme com o ID="1234" e seleccionarmos a ajuda premindo F1, veremos a nossa descrição de ajuda.

Lista de tarefas com ajuda de marcador