Configuración de componente Intro

org.eclipse.ui.intro.config

3.0

Este punto de extensión permite registrar una configuración de introducción. Esta configuración proporciona implementaciones y contenido de presentación para una contribución de introducción determinada. Una introducción aparece cuando se lanza por primera vez el entorno de trabajo y como opción del menú "Ayuda". La introducción se utiliza generalmente como presentar al usuario un producto incorporado a Eclipse.

Las introducciones se organizan en páginas que generalmente reflejan una categoría determinada de material introductorio. Por ejemplo, una página de Novedades puede presentar conceptos o funciones nuevos con respecto a versiones anteriores. Puede hacerse referencia y ampliarse el contenido definido por una configuración de introducción desde otros conectores mediante el punto de extensión org.eclipse.ui.intro.configExtension.

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

Un elemento config puede utilizarse para configurar un componente Intro personalizable. Un elemento config debe especificar un ID, un introId y un archivo de contenido. El archivo de contenido de hoja de intro es un archivo XML que describe las páginas, grupos y enlaces que contiene la introducción.



<!ELEMENT presentation (implementation+)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

Elemento presentation que define todas las implementaciones posibles de una presentación de componente intro. Puede contener una o varias implementaciones definidas. Durante el inicio sólo se elegirá una implementación, en función de los atributos os/ws de las implementaciones. De lo contrario, se elegirá la primera sin atributos os/ws.



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

La presentación de la plataforma tiene dos implementaciones posibles. Una de ellas se basa en el navegador de SWT, mientras que la otra se basa en formularios de UI. El componente intro personalizable puede configurarse para elegir de esas dos presentaciones en función de los OS y WS actuales. El tipo de la implementación puede ser swt o html.



A continuación figura un ejemplo de utilización del punto de extensión config.

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

Para obtener más detalles, consulte la especificación del paquete de API org.eclipse.ui.intro.config.

La introducción suministrada por el conector org.eclipse.platform es la única implementación de Eclipse.