Estensione configurazione parte introduzione

org.eclipse.ui.intro.configExtension

3.0

Questo punto di estensione è utilizzato per estendere una configurazione introduttiva esistente fornendo più contenuti, StandbyContentParts o azioni IntroUrl aggiuntive.

A partire dalla versione 3.2, questo punto di estensione viene utilizzato anche per aggiungere un tema di presentazione che può essere utilizzato dalle implementazioni di benvenuto per separare la presentazione e il contenuto.

<!ELEMENT extension (configExtension+ , standbyContentPart* , action* , theme*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT configExtension EMPTY>

<!ATTLIST configExtension

configId CDATA #REQUIRED

content  CDATA #REQUIRED>

Definisce un'estensione ad una configurazione introduttiva. Ogni pagina o gruppo della configurazione di una parte introduttiva può essere estesa, se è stata dichiarata come estensibile attraverso la definizione di ancoraggi.



<!ELEMENT standbyContentPart EMPTY>

<!ATTLIST standbyContentPart

id       CDATA #REQUIRED

pluginId CDATA #REQUIRED

class    CDATA #REQUIRED>

registrazione standbyContentPart. Una volta registrate, le parti in standby possono essere avviate con l'azione introURL nel seguente formato:

 
http://org.eclipse.ui.intro/showStandby?partId=&lt;id di standbyContentPart&gt;



<!ELEMENT action EMPTY>

<!ATTLIST action

name     CDATA #REQUIRED

replaces CDATA #REQUIRED>

registrazione dell'azione IntroURL personalizzata. Può essere utilizzata per creare nuove azioni IntroURL o collegamenti rapidi alle azioni predefinite.



<!ELEMENT theme (property*)>

<!ATTLIST theme

id           CDATA #REQUIRED

name         CDATA #REQUIRED

path         CDATA #REQUIRED

default      (true | false) "false"

previewImage CDATA #IMPLIED>


<!ELEMENT property EMPTY>

<!ATTLIST property

name  CDATA #REQUIRED

value CDATA #REQUIRED>

una proprietà tema facoltativa che può essere utilizzata dai configuratori dell'introduzione per personalizzare ulteriormente la presentazione introduttiva.



Di seguito viene riportato un esempio di implementazione del punto di estensione:

<extension point=

"org.eclipse.ui.intro.configExtension"

>

<configExtension configId=

"com.org.xyz.introConfig"

content=

"extensionContent.xml"

/>

<standbyContentPart id=

"com.org.xyz.myStandbyPart"

class=

"com.org.xyz.internal.MyStandbyContent"

pluginId=

"com.org.xyz"

/>

<action name=

"shortcutAction"

replaces=

"http://org.eclipse.ui.intro/showStandby?partId=com.org.xyz.myStandbyPart"

/>

<action name=

"customAction"

replaces=

"runAction?pluginId=com.org.xyz&amp;class=com.org.xyz.CustomAction&amp;param1=value1"

/>

<theme id=

"com.example.intro.flowers"

name=

"A Nice Flowers Welcome"

path=

"$nl$/themes/flowers"

previewImage=

"$nl$/themes/flowers/preview.png"

>

</theme>

</extension>

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

Sono disponibili tre implementazioni: