Tillhandahålla markörhjälp

Nu är vi redo att ta en titt på hur vi kan lägga till hjälp för readme-verktygets markörer.  Man lägger till markörhjälp genom att använda utökningspunkten org.eclipse.ui.ide.markerHelp.  Denna utökningspunkt gör det möjligt för insticksprogram att koppla ett hjälpkontext-id till en viss typ av markör.  Markören kan vara kvalificerad efter enbart markörtyp eller så kan den kvalificeras ytterligare genom värdet på ett eller flera av dess attribut.  Readme-verktyget deklarerar flera olika hjälpkontexter:

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

Varje markörhjälpskontext definieras för readme-markörtypen.  Däremot kopplas varje hjälpkontext till olika kombinationer av attributvärden.  Den första markörhjälpkontexten används för markörer vars id-attribut är angivet till "1234".  Hjälpkontexterna definieras i insticksprogrammets HelpContexts.xml-fil:

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

När vi väljer en readme-markör med id="1234" och sedan väljer hjälp med F1 så visas vår hjälpbeskrivning.

Aktivitetslista med markörhjälp