Contribution d'aide sur les marqueurs

Nous sommes prêts à étudier comment ajouter de l'aide aux marqueurs de l'outil readme. L'ajout d'aide s'effectue à l'aide du point d'extension org.eclipse.ui.markerHelp. Ce dernier permet aux plug-in d'associer un ID de contexte d'aide à un type particulier de marqueur. Le marqueur peut être qualifié uniquement selon son type ou bien qualifié par la valeur d'un ou plusieurs attributs. L'outil readme déclare différents contextes d'aide :

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

Chaque contexte d'aide de marqueur est défini pour le type de marqueur du readme. Toutefois, chacun est associé à une combinaison différente de valeurs d'attributs. Le premier contexte d'aide sera utilisé pour les marqueurs dont l'attribut id a la valeur "1234". Les contextes d'aide sont définis dans le fichier HelpContexts.xml du plug-in :

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

Lorsque nous sélectionnons un marqueur de readme avec id="1234" et appelons l'aide via la touche F1, nous pouvons voir notre description d'aide.

Liste de tâches avec l'aide sur les marqueurs

Copyright IBM Corporation and others 2000, 2003.