Nota Le procedure e gli esempi descritti di seguito si verificano in Lotus Expeditor e nell'Editor di applicazioni composite. Entrambi sono preziosi strumenti aggiuntivi per gli sviluppatori che creano applicazioni composite e componenti in Domino Designer.

Definizione delle proprietà attraverso un punto di estensione

È possibile definire proprietà dei componenti con un punto di estensione. Le proprietà e i loro valori predefiniti vengono aggiunti al componente quando il componente viene aggiunto a un'applicazione. La finestra di dialogo Modifica proprietà componente nell'Editor di applicazioni composite visualizza le proprietà nella scheda Impostazioni componente e permette agli utenti di impostarle.

Per utilizzare un punto di estensione per definire una proprietà di un componente, eseguire le seguenti operazioni:

1. Creare un'estensione new com.ibm.rcp.ca.utils.properties.

2. Fare clic con il pulsante destro del mouse sull'estensione e scegliere Nuovo > Proprietà.

3. Nel campo ID del nuovo elemento di proprietà, specificare un ID.

4. Nel campo referenceID, specificare un ID di vista o componente (definito nell'estensione com.ibm.rcp.aaf.paletteEntries). Sotto, il valore referenceID fa riferimento all'ID della vista Test View, com.ibm.rcp.test.view.

Nota Se ci sono due proprietà con lo stesso nome, uno associata a un ID vista e una all'ID componente, la proprietà associata all'ID componente è quella che viene visualizzata sulla scheda Impostazioni componente. Questo fornisce un migliore controllo sulle proprietà e sui valori di ogni componente. Una proprietà associata a un ID vista è applicata a tutti i componenti che utilizzano quell'ID vista (ad esempio, componenti di browser a gestione multipla, ciascuno dei quali necessita di una proprietà URL). Una proprietà associata a un ID componente viene applicata solo al componente con quell'ID. L'associazione di una proprietà a un ID componente permette di definire la proprietà per un componente specifico, senza applicarla ad altri componenti che possono utilizzare lo stesso ID vista.

5. Nel campo typeID, specificare uno dei tipi di proprietà predefiniti (stringa, booleano, numero, scelta, file, colore, nsfPicker (per i database Notes), directory o elenco (per le proprietà multivalore)). È possibile anche specificare un tipo personalizzato; per ulteriori informazioni, vedere "Definizione di tipi di proprietà personalizzati".

6. Nel campo del nome, specificare il nome della proprietà localizzabile.

7. Nel campo del valore, specificare il valore predefinito della proprietà, come un nome di file o un colore.

8. Nel campo delle limitazioni, immettere un elenco separato da punti e virgole dei limiti di valore o delle scelte appropriate per il tipo di proprietà, come mostrato di seguito:

• File - Fornire un elenco di estensioni (ad esempio, ".doc;xls;odt") fra cui l'utente può scegliere.
• Numero - Impostare i valori massimo e minimo; ad esempio, "1;100". Se non si impostano, l'Editor di applicazioni composite fornisce i valori predefiniti 0 e 100.
• Scelta - Specificare un elenco di scelte; ad esempio, "sì;no;forse".

Se si definisce una proprietà con un tipo personalizzato, è possibile anche fornire un controllo per consentire agli utenti di impostare il valore della proprietà. Per ulteriori informazioni, vedere di seguito "Definizione di tipi di proprietà personalizzati".

È possibile anche assegnare le proprietà a gruppi, in modo che vengono visualizzate accanto ad altre proprietà collegate sulla scheda Impostazioni componente. Per ulteriori informazioni, vedere Aggiunta di proprietà ai gruppi.

Definizione di tipi di proprietà personalizzati

È possibile definire proprietà dei componenti con tipi personalizzati e fornire controlli per l'editing di queste proprietà nella scheda Modifica proprietà composite dell'Editor di applicazioni composite.

Il punto di estensione com.ibm.rcp.ca.utils.properties ha un elemento "tipo" che è possibile utilizzare per definire un tipo personalizzato per una proprietà del componente. Per aggiungere l'elemento, seguire questa procedura.

1. Fare clic con il pulsante destro del mouse sull'estensione e scegliere Nuovo > Tipo.

2. Nell'elemento tipo, specificare un ID e un nome per il tipo e fare riferimento alla classe Java del tipo.

La classe Java deve implementare com.ibm.rcp.ca.utils.componentconfig.IComponentPreferenceType. Essa definisce il controllo di modifica che verrà visualizzato sulla scheda Modifica proprietà composite e, facoltativamente, un pulsante come un pulsante sfoglia o un selettore colore. Il controllo di modifica può essere composto e contenere più controlli.

Quando si definisce una proprietà con un tipo personalizzato nel punto di estensione com.ibm.rcp.ca.utils.properties, l'attribuito della proprietà "typeId" dovrebbe fare riferimento all'ID del tipo personalizzato.

Aggiunta di proprietà ai gruppi

È possibile raggruppare controlli di proprietà correlati nella scheda Impostazioni componente della finestra di dialogo Modifica proprietà componente.

È possibile aggiungere le proprietà ai gruppi in due modi.

• Creare un elemento gruppo e assegnare le proprietà al gruppo:
  • Fare clic con il pulsante destro del mouse sull'estensione e scegliere Nuovo > Gruppo.
  • Specificare nome e ID del nuovo gruppo.
  • Specificare il nuovo ID gruppo nel campo gruppo di ogni proprietà che si desidera raggruppare.
• Specificare nel campo gruppo il nome di ogni proprietà che si desidera raggruppare. L'Editor di applicazioni composite controllerà per vedere se la stringa fa riferimento a un ID di gruppo, altrimenti utilizza la stringa come nome del gruppo nella scheda Impostazioni componente.

Contributi alle schede alla finestra di dialogo Impostazioni componente

Per evidenziare le proprietà specifiche di un componente che fa parte di una vista, è possibile visualizzarle in una scheda a cui si contribuisce nella finestra di dialogo Impostazioni componente dell'Editor di applicazioni composite.

Per contribuire a una scheda per il componente, la propria parte della vista deve implementare l'interfaccia com.ibm.rcp.ca.utils.componentconfig.IPropertyTabsProvider.

Questa interfaccia fornisce a un metodo getTabs() (com.ibm.rcp.ca.utils.componentconfig.IpropertyTab [] getTabs), che l'Editor di applicazioni composite utilizza per aggiungere le schede alla finestra di dialogo Impostazioni componente. Ogni scheda ha accesso ai metodi com.ibm.rcp.ca.utils.componentconfig.IPropertyManager ed è responsabile di quanto segue:

• Disegnare di una propria area client con com.ibm.rcp.ca.utils.componentconfig.IPropertyTab.createControl()
• Mantenimento dell'interfaccia utente e dei dati aggiornati quando l'utente commuta fra le schede
• Aggiornamento dell'interfaccia utente con gli ultimi valori della proprietà quando viene attivata la scheda, con com.ibm.rcp.ca.utils.componentconfig.IPropertyTab.activating()
• Salvataggio delle proprietà prima della disattivazione, con com.ibm.rcp.ca.utils.componentconfig.IPropertyTab.deactivating()
• Gestione del proprio layout interno in modo che non venga distrutta l'estetica visiva della finestra di dialogo Impostazioni componente (ad esempio, assicurando che non diventi più grande dell'altezza o della larghezza dello schermo)

Si consideri un componente creato ampliando il componente Browser gestito esistente e implementando l'interfaccia com.ibm.rcp.ca.utils.componentconfig.IPropertyTabsProvider, come mostrato nel seguente frammento di codice:

public class MyBrowserView

  extends PAABrowserView

  implements IPropertyTabsProvider { …

Il componente crea nuove schede implementando l'interfaccia com.ibm.rcp.ca.utils.componentconfig.IPropertyTab per definire l'interfaccia utente della scheda:

public class BrowserTab implements IPropertyTab { …

public class LayoutTab implements IPropertyTab { …

Nota La scheda personalizzata può anche estendere com.ibm.rcp.ca.utils.componentconfig.AbstractPropertyTab, che fornisce le implementazioni predefinite di alcuni metodi.

Il codice implementa anche il metodo getTabs() in MyBrowserView per restituire le schede quando è richiesto:

public IPropertyTab[] getTabs() {

IPropertyTab[] _tabs = new IPropertyTab[2];

_tabs[0] = new BrowserTab();

_tabs[1] = new LayoutTab();

return _tabs;

}

Nell'Editor di applicazioni composite, la nuova scheda Browser viene visualizzata nella finestra di dialogo Impostazioni componente

Aggiunta dei controlli di impostazione delle proprietà direttamente ai componenti

Per rendere le proprietà del componente ancora più evidenti agli assemblatori di applicazioni, è possibile fornire controlli di impostazione delle proprietà che sono visibili nell'interfaccia utente del componente stesso, quando l'assemblatore di applicazioni lo modifica nell'Editor di applicazioni composite.

Per aggiungere questa interfaccia utente aggiuntiva, creare il seguente codice per la classe del componente:

• Controllare che il valore della proprietà com.ibm.rcp.editingApplication sia vero prima di visualizzare l'interfaccia utente aggiuntiva che viene fornita
• Fare in modo che la classe ViewPart implementi l'interfaccia com.ibm.rcp.ca.utils.componentconfig.IComponentConfigurator:

  public class MyView extends ViewPart implements IComponentConfigurator

• Implementare il metodo setSaveablePropertyManager(ISaveablePropertyManager propMgr). Quando il componente viene aggiunto a un'applicazione composita, l'Editor di applicazioni composite controlla per vedere se la vista del componente implementa l'interfaccia IsaveablePropertyManager. In caso affermativo, l'editor chiama il metodo setSaveablePropertyManager, che passa un gestore di proprietà. Questo gestore di proprietà permette all'utente di acquisire e impostare le proprietà e salvare, o salvare e aggiornare. Chiamando il metodo salva o salvare e aggiorna si dice all'editor di salvare o salvare e aggiornare l'applicazione, salvando tutte le modifiche nell'XML dell'applicazione composita.

Per informazioni complete sulle attività descritte e sull'utilizzo dell'Editor di applicazioni composite e di Lotus Expeditor, fare riferimento alla documentazione del prodotto fornita con ogni strumento. L'editor di applicazioni composite è installato come opzione quando si installa il client IBM® Lotus® Notes® Standard.

Dettagli aggiuntivi possono essere trovati anche sul wiki del prodotto Lotus Expeditor (http://www-10.lotus.com/ldd/lewiki.nsf)

Glossario

Guida sulla Guida

Contenuto completo della Guida

Glossario