Erweiterung für Konfiguration von Einführungskomponenten

org.eclipse.ui.intro.configExtension

3.0

Dieser Erweiterungspunkt dient zur Erweiterung einer vorhandenen Einführungskonfiguration durch Bereitstellung weiterer Inhalte, zusätzlicher StandbyContentParts oder zusätzlicher IntroUrl-Aktionen.

Ab Version 3.2 wird dieser Erweiterungspunkt außerdem verwendet, um ein Darstellungsthema zu ergänzen, mit dem Implementierungen von Startseiten die Darstellung und den Inhalt voneinander trennen können.

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

Definiert eine Erweiterung einer Einführungskonfiguration. Jede Seite oder Gruppe in einer Einführungskomponentenkonfiguration kann erweitert werden, wenn die Erweiterungsfähigkeit durch definierende Anker deklariert worden ist.



<!ELEMENT standbyContentPart EMPTY>

<!ATTLIST standbyContentPart

id       CDATA #REQUIRED

pluginId CDATA #REQUIRED

class    CDATA #REQUIRED>

standbyContentPart Registrierung. Wenn sie einmal registriert sind, können "standby"-Komponenten durch eine introURL-Aktion des folgenden Formats gestartet werden:

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



<!ELEMENT action EMPTY>

<!ATTLIST action

name     CDATA #REQUIRED

replaces CDATA #REQUIRED>

Registrierung der angepassten URL-Aktion für die Einführung. Dies kann verwendet werden, um neue URL-Aktionen für die Einführung oder einen Direktaufruf für vordefinierte Aktionen zu erstellen.



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

Eine optionale Themeneigenschaft, mit der Konfigurationsfunktionen für Einführungen die Darstellung der Einführungp weiter anpassen können.



Das folgende Beispiel zeigt eine Implementierung dieses Erweiterungspunktes:

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

Weitere Details finden Sie in der Spezifikation für das API-Paket "org.eclipse.ui.intro.config".

Es stehen drei Implementierungen zur Verfügung: