Configurazione parte introduttiva
Identificativo:
org.eclipse.ui.intro.config
Da:
3.0
Descrizione:
Questo punto di estensione viene utilizzato per
registrare una configurazione introduttiva. Questa configurazione fornisce le implementazioni e il
contenuto di una presentazione per un contributo introduttivo dato. L'introduzione viene visualizzata quando
il workbench viene avviato per la prima volta e come scelta del menu "Guida". L'introduzione viene
generalmente utilizzata per presentare ad un utente un prodotto generato in Eclipse.
Le introduzioni sono organizzate in pagine che abitualmente riflettono una particolare categoria di
materiale introduttivo.
Ad esempio, una pagina Novità può introdurre nuovi concetti e funzionalità rispetto ad una versione
precedente. Il contenuto definito da una configurazione introduttiva viene referenziato e esteso da
altri plugin utilizzando il punto di estensione org.eclipse.ui.intro.configExtension.
Tag di configurazione:
<!ELEMENT extension (config+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificativo completo del punto di estensione di
destinazione
- id - identificativo dell'istanza dell'estensione
- name - nome dell'istanza dell'estensione facoltativo
<!ELEMENT config (presentation)>
<!ATTLIST config
introId CDATA #REQUIRED
id CDATA #REQUIRED
content CDATA #REQUIRED>
Un elemento config può essere utilizzato per configurare una parte introduttiva personalizzabile. Un elemento
config deve specificare un id, un introId e un file di contenuto.
Un file di contenuto introduttivo è un file XML che descrive le pagine, i gruppi e i collegamenti
dell'introduzione.
- introId - l'id del contributo della parte introduttiva con la quale è associata questa
configurazione.
- id - nome univoco che è possibile utilizzare per identificare questa configurazione introduttiva.
- content - un file di contenuto introduttivo. Il file di contenuto è un file XML che contiene le
specifiche dell'introduzione (specifiche del formato file del contenuto
introduttivo).
Il file del contenuto viene analizzato al runtime dal framework introduttivo. In base alle impostazioni di
questo file, un certo numero di pagine, gruppi e collegamenti sono visualizzati all'utente quando viene
aperta l'introduzione.
<!ELEMENT presentation (implementation+)>
<!ATTLIST presentation
home-page-id CDATA #REQUIRED
standby-page-id CDATA #IMPLIED>
Elemento di presentazione che definisce tutte le possibili implementazioni di una presentazione della parte
introduttiva. Possono essere definite una o più implementazioni. Una sola implementazione sarà scelta
all'avvio, in base agli attributi os/ws delle implementazioni. Altrimenti verrà scelta la prima senza
attributi os/ws definiti.
- home-page-id - l'id della pagina home (principale), che rappresenta la prima pagina
dell'introduzione. Questa pagina può essere utilizzata come punto di ingresso ad altre pagine principali
che costituiscono l'introduzione.
- standby-page-id - un attributo facoltativo che definisce l'id della pagina di standby. La pagina
di standby sarà visualizzata all'utente quando si pone in standby l'introduzione.
<!ELEMENT implementation (head?)>
<!ATTLIST implementation
kind (swt|html)
style CDATA #IMPLIED
os CDATA #IMPLIED
ws CDATA #IMPLIED>
La presentazione delle esperienze della piattaforma presenta due implementazioni. Una è basta sul browser
SWT, l'altra sui moduli dell'interfaccia utente. La parte introduttiva personalizzabile può essere
configurata per utilizzare una di queste due presentazioni in base al sistema operativo (OS) o al sistema
di gestione finestre (WS). Il tipo di implementazione è swt o html.
- kind - specifica il tipo di implementazione. Il tipo swt indica un'implementazione basta su
moduli UI, il tipo html indica un'implementazione basta su browser SWT.
- style - lo stile condiviso che sarà applicato a tutte le pagine presentate da questa
implementazione della presentazione introduttiva.
- os - la specifica facoltativa del sistema operativo utilizzato nella scelta dell'implementazione
della presentazione. Può essere uno degli identificativi di sistema operativo definiti da Eclipse,
ovvero win32, linux, ecc. (fare riferimento a Javadoc per
org.eclipse.core.runtime.Platform
).
- ws - la specifica facoltativa del sistema di gestione finestre (windowing) utilizzato nella scelta
dell'implementazione
della presentazione. Può essere uno degli identificativi del sistema di gestione finestre definiti da Eclipse (fare riferimento a Javadoc per
org.eclipse.core.runtime.Platform
).
Esempi:
Di seguito è riportato un utilizzo esemplificativo del
punto di estensione config.
<extension id=
"intro"
point=
"org.eclipse.ui.intro.config"
>
<config
introId=
"com.org.xyz.intro"
id=
"com.org.xyz.introConfig"
content=
"introContent.xml"
>
<presentation
home-page-id=
"root"
title=
"%intro.title"
>
<implementation
ws=
"win32"
style=
"css/shared.css"
kind=
"html"
os=
"win32"
>
</implementation>
<implementation
style=
"css/shared_swt.properties"
kind=
"swt"
>
</implementation>
</presentation>
</config>
</extension>
Informazione API:
per ulteriori dettagli fare riferimento alle
specifiche per il pacchetto API org.eclipse.ui.intro.config.
Implementazione fornita:
Il contributo del plugin
org.eclipse.platform è l'unica implementazione fornita in Eclipse.
Copyright (c) 2004 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