Bidrag til markeringshjælp

Vi skal nu se på, hvordan der føjes hjælp til Readme-værktøjets markeringer. Markeringshjælp tilføjes med udvidelsespunktet org.eclipse.ui.ide.markerHelp. Udvidelsespunktet giver plugins mulighed for at tilknytte en hjælpekontekst-id med en bestemt markeringstype. Markeringen kan kvalificeres med kun markeringstypen, eller den kan kvalificeres yderligere med værdien af en eller flere af dens attributter. Readme-værktøjet erklæres flere forskellige hjælpekontekster:

<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> 
   ...

Hver markeringshjælpekontekst er defineret for Readme-markeringstypen. Hver hjælpekontekst er imidlertid tilknyttet med en anden kombination af attributværdier. Den første markeringshjælpkontekst bruges til markeringer, hvis id-attribut er angivet til "1234". Hjælpekontekster er defineret i plugin'ens HelpContexts.xml-fil:

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

Hjælpebeskrivelsen vises, når du vælger en Readme-markering med id="1234" og vælger hjælp med F1.

Opgaveliste med markeringshjælp