Agora estamos prontos para ver como adicionar ajuda aos marcadores da ferramenta Leia-me. A inclusão da ajuda do marcador é feita utilizando o ponto de extensãoorg.eclipse.ui.ide.markerHelp. Esse ponto de extensão permite aos plug-ins associar um ID de contexto de ajuda a um tipo específico 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.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 do marcador é definido para o tipo de marcador readme. 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 estiver 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.
