Esittelyosarakenteen laajennus

org.eclipse.ui.intro.configExtension

3.0

Tämän laajennuspisteen avulla voi laajentaa aiemmin määritettyä esittelyrakennetta lisäsisällöllä, standbyContentPart-lisäosilla tai introUrl-lisätoiminnoilla.

Versiosta 3.2 alkaen tätä laajennuspistettä käytetään myös toimittamaan esitysteema, jota voi käyttää tervetulototeutuksissa esityksen ja sisällön erottamiseen.

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

Esittelyrakenteen laajennuksen määritys. Mitä tahansa esittelyosarakenteen sivua tai ryhmää voi laajentaa, jos siihen on määritetty ankkurielementtejä (anchor) laajennuksia varten.



<!ELEMENT standbyContentPart EMPTY>

<!ATTLIST standbyContentPart

id       CDATA #REQUIRED

pluginId CDATA #REQUIRED

class    CDATA #REQUIRED>

StandbyContentPart-elementin rekisteröinti. Rekisteröidyt standby-osat voi suorittaa introURL-toimintoina seuraavassa muodossa:

 
http://org.eclipse.ui.intro/showStandby?partId=&lt;standbyContentPart-osan tunnus&gt;



<!ELEMENT action EMPTY>

<!ATTLIST action

name     CDATA #REQUIRED

replaces CDATA #REQUIRED>

Mukautetun esittelyn URL-toiminnon rekisteröinti. Tämän elementin avulla voi luoda uusia esittelyn URL-toimintoja tai aiemmin määritettyjen toimintojen pikavalintoja.



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

valinnainen teeman ominaisuus, jonka avulla johdannon määrittäjät voivat mukauttaa johdantoesitystä tarkasti.



Seuraavassa on tämän laajennuspisteen toteutusesimerkki:

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

Lisätietoja on API-paketin org.eclipse.ui.intro.config määrityksessä.

Seuraavat kolme toteutusta on toimitettu: