Configurazione parte introduttiva

org.eclipse.ui.intro.config

3.0

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.

<!ELEMENT extension (config+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!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.



<!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.



<!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.



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>

per ulteriori dettagli fare riferimento alle specifiche per il pacchetto API org.eclipse.ui.intro.config.

Il contributo del plugin org.eclipse.platform è l'unica implementazione fornita in Eclipse.