Rozszerzenie konfiguracji części wprowadzenia

org.eclipse.ui.intro.configExtension

3.0

Ten punkt rozszerzenia umożliwia rozszerzenie istniejącej konfiguracji wprowadzenia przez udostępnienie dodatkowej treści, dodatkowych części StandbyContentParts lub dodatkowych akcji IntroUrl.

Od wersji 3.2 opisywany punkt rozszerzenia służy także do wnoszenia kompozycji prezentacji, która może być wykorzystywana przez implementacje powitania do oddzielania prezentacji i treści.

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

Definiuje rozszerzenie konfiguracji wprowadzenia. Można rozszerzyć dowolną stronę lub grupę w konfiguracji części wprowadzenia, jeśli zadeklarowano w niej możliwość rozszerzania przez zdefiniowanie zakotwiczeń.



<!ELEMENT standbyContentPart EMPTY>

<!ATTLIST standbyContentPart

id       CDATA #REQUIRED

pluginId CDATA #REQUIRED

class    CDATA #REQUIRED>

Rejestracja części standbyContentPart. Po zarejestrowaniu części trybu gotowości można je uruchamiać przy użyciu akcji introURL o następującym formacie:

 
http://org.eclipse.ui.intro/showStandby?partId=&lt;identyfikator części standbyContentPart&gt;



<!ELEMENT action EMPTY>

<!ATTLIST action

name     CDATA #REQUIRED

replaces CDATA #REQUIRED>

Rejestracja niestandardowej akcji adresu URL wprowadzenia. Umożliwia ona tworzenie nowych akcji adresu URL wprowadzenia lub skrótów do akcji predefiniowanych.



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

Opcjonalna właściwość kompozycji, która może być wykorzystywana przez konfiguratory wprowadzeń do dalszego dostosowywania sposobu ich prezentacji.



Poniżej przedstawiono przykładową implementację tego punktu rozszerzenia:

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

"Powitanie z kwiatami"

path=

"$nl$/themes/flowers"

previewImage=

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

>

</theme>

</extension>

Bardziej szczegółowe informacje zawiera specyfikacja pakietu interfejsu API org.eclipse.ui.intro.config.

Dostarczane są trzy implementacje: