Extensão de Configuração do Componente Intro

org.eclipse.ui.intro.configExtension

3.0

Este ponto de extensão é utilizado para expandir uma configuração do componente Intro fornecendo mais conteúdos, acções adicionais StandbyContentParts ou IntroUrl.

A partir da versão 3.2, este ponto de extensão é também utilizado para contribuir com um tema de apresentação que pode ser utilizado por implementações de boas-vindas para separar a apresentação e o conteúdo.

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

Define uma extensão numa configuração de introdução. Qualquer página ou grupo numa configuração de componente Intro pode ser expandida, se declarou a extensibilidade definindo referências.



<!ELEMENT standbyContentPart EMPTY>

<!ATTLIST standbyContentPart

id       CDATA #REQUIRED

pluginId CDATA #REQUIRED

class    CDATA #REQUIRED>

registro de standbyContentPart. Assim que for registado, os componentes em espera podem ser lançados através de uma acção introURL no formato seguinte:

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



<!ELEMENT action EMPTY>

<!ATTLIST action

name     CDATA #REQUIRED

replaces CDATA #REQUIRED>

registro de acção do URL de Intro personalizado. Pode ser utilizado para criar novas acções do URL de Intro ou um atalho para as acções predefinidas.



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

uma propriedade do tema opcional que pode ser utilizada por configuradores de introdução para personalizar ainda mais a apresentação da introdução.



A seguir encontra-se um exemplo da implementação deste ponto de extensão.

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

Para mais detalhes consulte a especificação para o pacote de API org.eclipse.ui.intro.config.

Existem três implementações fornecidas: