Pagine delle proprietà

Identificativo: org.eclipse.ui.propertyPages

Descrizione: questo punto di estensione consente di aggiungere ulteriori pagine delle proprietà a oggetti di un dato tipo.  Una volta definite, tali pagine vengono visualizzate nella finestra delle proprietà degli oggetti di quel tipo.

Una pagina delle proprietà consente una facile interazione con le proprietà di un oggetto.  A differenza della visualizzazione Proprietà che non consente di effettuare molte modifiche alle proprietà di un oggetto, questa pagina è caratterizzata dalla possibilità di definire controlli più complessi e più estesi con etichette, icone e così via.  Le proprietà logicamente connesse possono essere raggruppate in una sola pagina, invece di disperderle nel foglio delle proprietà. Tuttavia, nella maggior parte applicazioni, è consigliabile rendere disponibili alcune proprietà attraverso il foglio delle proprietà e altre attraverso le pagine delle proprietà.

Le pagine delle proprietà vengono mostrate in una finestra di dialogo, solitamente visibile quando si seleziona la voce di menu Proprietà nel menu di scelta rapida di un oggetto. Oltre alla classe dell'oggetto, può essere specificato il filtro del nome, in modo da registrare le pagine della proprietà solo per determinati tipi di oggetto.

Se questo metodo di filtraggio dovesse risultare insufficiente, è possibile utilizzare un altro meccanismo di filtro.  In questo caso, gli attributi dell'oggetto di destinazione vengono specificati in una serie di coppie di valori chiave.  Gli attributi che si applicano alla selezione sono di un tipo specifico e diverso rispetto al dominio del workbench, in modo che il filtraggio a questo livello venga delegato dal workbench alla selezione corrente.

Tag di configurazione:

   <!ELEMENT page (filter)*>
   <!ATTLIST page
      id           CDATA #REQUIRED
      name         CDATA #REQUIRED
      icon         CDATA #IMPLIED
      objectClass  CDATA #REQUIRED
      class        CDATA #REQUIRED
      nameFilter   CDATA #IMPLIED
   >

   <!ELEMENT filter EMPTY>
   <!ATTLIST filter
      name       CDATA #REQUIRED
      value      CDATA #REQUIRED
   > Esempi:

Di seguito viene riportato un esempio della definizione di una pagina della proprietà:

   <extension point="org.eclipse.ui.propertyPages">
      <page
         id="com.xyz.projectPage"
         name="XYZ Java Properties"
         objectClass="org.eclipse.core.resources.IFile"
         class="com.xyz.ppages.JavaPropertyPage"
         nameFilter="*.java">
         <filter name="readOnly" value="true"/>
      </page>
    </extension>

Informazioni API: l'attributo class deve specificare un nome completo della classe che implementa org.eclipse.ui.IWorkbenchPropertyPage.

Implementazione fornita: alcuni oggetti forniti dal workbench potrebbero avere pagine delle proprietà registrate. I plug-in possono aggiungere ulteriori pagine delle proprietà per questi oggetti. Le risorse del workbench non costituiscono un limite per le pagine delle proprietà: tutti gli oggetti mostrati nel workbench, anche gli oggetti specifici del dominio, possono avere avere pagine delle proprietà e ad altri plug-in è consentito registrare pagine per questi oggetti.

Copyright IBM Corp. 2000, 2001. Tutti i diritti riservati.