Aggiunta di una pagina delle proprietà

È possibile fornire una pagina delle proprietà per un oggetto utilizzando il punto di estensione org.eclipse.ui.propertyPages. La pagina delle proprietà di un oggetto viene richiamata utilizzando il menu Proprietà in qualsiasi vista che includa oggetti, ad esempio la vista Selezione della risorsa. Tale menu è disponibile quando viene selezionato un singolo oggetto. 

Lo strumento readme fornisce due pagine delle proprietà.

<extension
     point = "org.eclipse.ui.propertyPages">
        <page
           id="org.eclipse.ui.examples.readmetool.FilePage"
           name="%PropertiesPage.filePage"
	   objectClass="org.eclipse.core.resources.IFile"
	   class="org.eclipse.ui.examples.readmetool.ReadmeFilePropertyPage"
           nameFilter="*.readme">
        </page>
         <page
            id="org.eclipse.ui.examples.readmetool.FilePage2"
            name="%PropertiesPage.filePage2"
 	   objectClass="org.eclipse.core.resources.IFile"
 	   class="org.eclipse.ui.examples.readmetool.ReadmeFilePropertyPage2"
            nameFilter="*.readme">
         </page>
  </extension>

Quando si definisce una pagina delle proprietà, si specifica la classe objectClass per la quale è valida la pagina. Gli oggetti di questa classe includeranno la pagina al momento della visualizzazione delle proprietà.  Se si desidera, è possibile fornire un nameFilter che specifichi ulteriormente la classe. Nell'esempio di strumento readme vengono fornite entrambe le pagine per gli oggetti di tipo IFile con un'estensione file .readme.

Le pagine delle proprietà non sono limitate alle risorse del workbench. Tutti gli oggetti visualizzati nel workbench (anche gli oggetti specifici del dominio creati da altri plugin) possono disporre di pagine delle proprietà. Tutti i plugin possono registrare pagine delle proprietà per qualsiasi tipo di oggetto.

Le pagine delle proprietà somigliano molto alle pagine delle preferenze, ad eccezione del fatto che non è presente una gerarchia o una divisione in categorie. Nella finestra di dialogo sottostante, entrambe le pagine delle proprietà del readme appaiono nell'elenco principale delle pagine.

Finestra Proprietà con voci del readme