Contribuindo com Ajuda do Marcador

Agora, estamos prontos para ver como incluir ajuda nos marcadores da ferramenta Leia-me.  A inclusão de ajuda do marcador é feita utilizando o ponto de extensão org.eclipse.ui.markerHelp.  Este ponto de extensão permite que os plug-ins associem um id de contexto de ajuda a um determinado tipo de marcador.  O marcador pode ser qualificado apenas pelo tipo de marcador, ou pode ser qualificado também pelo valor de um ou mais de seus atributos.  A ferramenta Leia-me declara vários contextos de ajuda 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 ajuda do marcador é definido para o tipo de marcador do Leia-me.  Entretanto, cada contexto de ajuda é associado a uma combinação diferente de valores de atributos.  O primeiro contexto de ajuda do marcador será utilizado para marcadores cujo atributo id esteja definido como "1234".  Os contextos de ajuda são definidos no arquivo HelpContexts.xml do plug-in:

<context id="marker_example1_context" >
	<description>Readme marker example 1 <b>Help</b> id = 1234 </description>
</context>

Com certeza, quando selecionarmos um marcador do Leia-me com id="1234" e selecionarmos a ajuda utilizando F1, veremos a descrição da ajuda.

Lista de tarefas com ajuda do marcador

Copyright IBM Corp. e outros 2000,2002.