Ultima revisione 25 marzo 2003 per Eclipse 2.1
La sezione "informazioni su" di una funzione viene creata dalle proprietà del file "about.ini
" situato all'interno del plug-in della funzione.
Si tratta di un file di formato java.io.Properties
(codifica di caratteri ISO 8859-1 con caratteri di escape Unicode \uxxxx ),
con le seguenti chiavi:
aboutText
" - descrizione di testo su più righe
della funzione contenente il copyright, i termini e le condizioni della
licenza, le informazioni di registrazione della licenza, ecc.; gli URL trovati
nel testo sono presentati come collegamenti. Le interruzioni di riga sono indicate da "\n
"; le righe non devono essere più lunghe di 75 caratteri ciascuna e esiste un limite di 15 righe. Queste informazioni sono visualizzate nella finestra di dialogo "informazioni su" principale (in combinazione con un'immagine
in formato ridotto) e nella finestra di dialogo "informazioni su"
secondaria che descrive le singole funzioni. Tutte le funzioni devono avere questa proprietà.windowImage
" - immagine a colori da 16x16 pixel utilizzata per apporre un marchio alle finestre create da un prodotto. Il valore di questa proprietà è un percorso relativo al plug-in di un file di immagine. Questa proprietà è necessaria solo per le funzioni principali; le altre funzioni possono ometterla.featureImage
" - immagine a colori da 32x32 pixel utilizzata come icona della funzione. Il valore di questa proprietà è un percorso relativo al plug-in di un file di immagine. Questa immagine viene visualizzata nella finestra di dialogo "informazioni su" che descrive le singole funzioni, nonché nella finestra di dialogo "informazioni su" principale, per indicare che la funzione è presente. Questa proprietà è opzionale. Le
funzioni correlate fornite da un singolo fornitore devono contenere copie
dell'identico file di immagine; questo consente di eliminare le immagini duplicate.aboutImage
" - immagine a colori di grandi dimensioni che viene visualizzata nella finestra di dialogo "informazioni su" principale di un prodotto. Il valore di questa proprietà è un percorso relativo al plug-in di un file di immagine. Questa proprietà è necessaria solo per le funzioni principali; le altre funzioni devono ometterla. Sono supportati sia i layout con grafica e testo che quelli con sola grafica, a seconda della dimensione dell'immagine fornita. Un'immagine di dimensioni ridotte, che preveda fino a 250 pixel in larghezza e 330 in altezza, viene visualizzata nella finestra di dialogo "informazioni su" principale con il testo (proprietà "aboutText
") accanto ad essa. Un'immagine di dimensioni complete, che preveda fino a 500 pixel in larghezza e 330 in altezza, viene visualizzata senza testo.welcomePage
" - pagina di benvenuto. Il valore di questa proprietà è un percorso relativo al plug-in di un file di immagine di formato XML contenente la pagina di benvenuto della funzione. Questa proprietà è consigliata per tutte le funzioni principali; le altre funzioni possono ometterla.welcomePerspective
" - prospettiva preferenziale in cui visualizzare la pagina di benvenuto. Il valore di questa proprietà è un ID di prospettiva del workbench. Questa
proprietà è consigliata per le funzioni con pagine di benvenuto che vengono
visualizzate meglio nel contesto delle viste e degli editor della funzione. Le funzioni che non hanno pagine di benvenuto o per cui la posizione in cui saranno visualizzate le pagine di benvenuto non ha alcuna importanza devono ometterla.appName
" - breve stringa utilizzata per associare un nome all'applicazione sulle piattaforme in cui questa operazione abbia un senso. Negli ambienti operativi con il sistema a finestra Motif, il valore viene utilizzato per la ricerca delle risorse Motif (vedere xrdb ed elementi correlati). Inoltre, nel gestore delle finestre CDE (utilizzando in Solaris e AIX), si tratta del nome che viene visualizzato sotto l'icona delle finestre ridotte a icona sul desktop. Questa proprietà è necessaria per le funzioni principali, le altre possono ometterla.tipsAndTricksHref
" - la sezione Consigli e
suggerimenti della documentazione della guida. Il valore di questa proprietà
rappresenta un riferimento al manuale contenente la sezione Consigli e
suggerimenti, ad esempio, tipsAndTricksHref=/org.eclipse.jdt.doc.user/tips/jdt_tips.html
.
Questa proprietà è consigliata per tutte le funzioni principali; le altre funzioni possono ometterla.