Guida dell'indicatore

Identificativo: org.eclipse.ui.markerHelp

Da: versione 2.0

Descrizione: questo punto di estensione è utilizzato per associare un id di contesto della guida a uno specifico "tipo" di indicatore (un indicatore di un tipo determinato o con attributi aventi determinati valori).

Tag di configurazione:

   <!ELEMENT extension (markerHelp*)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

   <!ELEMENT markerHelp (attribute*)>

   <!ATTLIST markerHelp
     markerType    CDATA #IMPLIED
     helpContextId CDATA #REQUIRED
   >

   <!ELEMENT attribute EMPTY>

   <!ATTLIST attribute
     name  CDATA #REQUIRED
     value CDATA #REQUIRED
   >

Esempi: di seguito è riportato un esempio di estensione di guida dell'indicatore (si osservino l'elemento secondario e la modalità di utilizzo degli attributi):

 <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>
 </extension>

Nell'esempio sopra riportato, un id di contesto della guida è associato a indicatori di tipo org.eclipse.ui.examples.readmetool.readmemarker il cui attributo org.eclipse.ui.examples.readmetool.id ha un valore 1234.

Informazioni API: è compito dello sviluppatore verificare che per uno specifico indicatore sia fornito soltanto un singolo id contesto guida. Se vengono forniti due o più id contesto guida, il workbench non definisce quale verrà restituito. Il workbench, tuttavia, definisce che per un determinato indicatore sarà sempre restituito l'id contesto "più specifico". Di conseguenza, un id contesto associato a tre valori corrispondenti dell'attributo verrà restituito prima di un id contesto associato a due valori soltanto.

Copyright (c) 2002, 2003 IBM Corporation e altri. Tutti i diritti riservati. Questo programma e il materiale di accompagnamento sono disponibili secondo i termini della Common Public License v1.0 che sono distribuiti con il prodotto, e disponibili all'indirizzo http://www.eclipse.org/legal/cpl-v10.html