Introduktionsdel - konfigurationsudvidelse

org.eclipse.ui.intro.configExtension

3.0

Dette udvidelsespunkt bruges til at udvide en eksisterende introduktionskonfiguration ved at levere mere indhold, ekstra StandbyContentParts eller ekstra IntroUrl-funktioner.

Fra 3.2 anvendes dette udvidelsespunkt også til at levere et præsentationstema, der kan anvendes af Velkommen-implementeringer til at adskille præsentation og indhold.

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

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT configExtension EMPTY>

<!ATTLIST configExtension

configId CDATA #REQUIRED

content  CDATA #REQUIRED>

Definerer en udvidelse af en introduktionskonfiguration. Enhver side eller gruppe i en introduktionsdelskonfiguration kan udvides, hvis den har erklæret udvidelsesmuligheder ved at definere ankre.



<!ELEMENT standbyContentPart EMPTY>

<!ATTLIST standbyContentPart

id       CDATA #REQUIRED

pluginId CDATA #REQUIRED

class    CDATA #REQUIRED>

Registrering af standbyContentPart. Når standbydelene er registreret, kan de startes vha. en introURL-funktion i følgende format:

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



<!ELEMENT action EMPTY>

<!ATTLIST action

name     CDATA #REQUIRED

replaces CDATA #REQUIRED>

Registrering af tilpasset funktion til en introduktions-URL. Dette kan bruges til at oprette nye funktioner til en introduktions-URL eller genveje til foruddefinerede funktioner.



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

en valgfri temaegenskab, der kan anvendes af introduktionskonfigurationer til at tilpasse introduktionspræsentationen.



Her er et eksempel på dette udvidelsespunkt:

<udvidelsespunkt=

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

Der er flere oplysninger i specifikationerne til API-pakken org.eclipse.ui.intro.config.

Der er tre medfølgende implementeringer: