Intro-Komponentenkonfiguration

org.eclipse.ui.intro.config

3.0

Dieser Erweiterungspunkt dient zur Registrierung einer Intro-Konfiguration. Diese Konfiguration stellt Präsentationsimplementierungen und Inhalte für eine bestimmte Intro-Ergänzung zur Verfügung. Eine Einführung wird angezeigt, wenn die Workbench zum ersten Mal gestartet wird oder wenn sie über das Menü 'Hilfe' aufgerufen wird. Die Einführung wird üblicherweise verwendet, um einen Benutzer in ein auf Eclipse aufgebautes Produkt einzuführen.

Die Einführungen sind in Seiten zusammengefasst, die üblicherweise eine bestimmte Kategorie des einführenden Materials widerspiegeln. Sie werden z.B, auf der Seite 'Neue Funktionen' neue Konzepte oder Funktionen seit der vorhergehenden Version vorgestellt. Der Inhalt, der durch eine Intro-Konfiguration definiert wird, kann durch andere Plug-ins unter Verwendung des Erweiterungspunkts org.eclipse.ui.intro.configExtension referenziert oder erweitert werden.

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

Ein Element 'config' kann verwendet werden, um eine anpassungsfähige Intro-Komponente zu konfigurieren. Das Element 'config' muss eine ID, eine introID und eine Inhaltsdatei angeben. Bei der Inhaltsdatei der Einführung handelt es sich um eine XML-Datei, die die Seiten, Gruppen und Links der Einführung beschreibt.



<!ELEMENT presentation (implementation+)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

Darstellungselement, das alle möglichen Implementierungen der Darstellung einer Intro-Komponente definiert. Darin können eine oder mehrere Implementierungen definiert sein. Beim Start wird nur eine Implementierung ausgewählt, basierend auf den Attributen für das Betriebssystem/Fenstertechniksystem der Implementierungen. Andernfalls wird die erste ohne Attribute für das Betriebssystem/Fenstertechniksystem ausgewählt.



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style   CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

Die Darstellung der sofort einsatzfähigen Plattformfunktion hat zwei Implementierungen. Eine davon basiert auf dem SWT-Browser, die andere auf Benutzerschnittstellenformularen. Die anpassungsfähige Intro-Komponente kann so konfiguriert werden, dass sie eine der beiden Darstellungen, basierend auf dem aktuellen Betriebssystem und Fenstertechniksystem, auswählt. Die Art der Implementierung kann SWT oder HTML sein.



Das folgende Beispiel zeigt die Verwendung des 'config'-Erweiterungspunkts.

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

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

Die durch das Plug-in 'org.eclipse.platform' ergänzte Intro ist die einzige Implementierung innerhalb von Eclipse.