Pagina delle preferenze

Identificativo: org.eclipse.ui.preferencePages

Descrizione: il workbench dispone di una finestra di dialogo comune per le preferenze. Questo punto di estensione consente ai plug-in di aggiungere pagine alla finestra di dialogo delle preferenze. Quando questa finestra viene aperta dalla barra dei menu, le pagine specificate vengono aggiunte alla finestra di dialogo.

La finestra di dialogo delle preferenze consente di raccogliere gerarchicamente le pagine. Pertanto, è possibile specificare l'attributo category della pagina. Questo attributo rappresenta un percorso composto dagli ID delle pagine principali separati da '/'. Se tale attributo non viene specificato o se non è possibile rilevare uno dei nodi principali del percorso, la pagina viene aggiunta al livello principale.

Tag di configurazione:

   <!ELEMENT extension (page*)>

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

   <!ELEMENT page EMPTY>

   <!ATTLIST page
      id       CDATA #REQUIRED
     name     CDATA #REQUIRED
     class    CDATA #REQUIRED
     category CDATA #IMPLIED
   >

Esempi: di seguito è riportato un esempio di utilizzo del punto di estensione delle preferenze:

   <extension 
       point="org.eclipse.ui.preferencePages"> 
      <page 
         id="com.xyz.prefpage1" 
         name="XYZ" 
         class="com.xyz.prefpages.PrefPage1"> 
      </page> 
      <page 
         id="com.xyz.prefpage2" 
         name="Keyboard Settings" 
         class="com.xyz.prefpages.PrefPage2" 
         category="com.xyz.prefpage1"> 
      </page> 
   </extension> 

Informazioni API: il valore della classe di attributo deve corrispondere al nome completo della classe che implementa org.eclipse.ui.IWorkbenchPreferencePage.

Implementazione fornita:il workbench aggiunge alcune pagine per impostare le preferenze della piattaforma. Le pagine registrate utilizzando l'estensione verranno aggiunte dopo queste, in base alle informazioni sulla categoria.

Copyright (c) 2002 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