Configuración de componente Intro
Identificador:
org.eclipse.ui.intro.config
A partir del release:
3.0
Descripción:
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.
Código de configuración:
<!ELEMENT extension (config+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point: identificador totalmente calificado del punto de extensión destino
- id: identificador opcional de la instancia de extensión
- name: nombre opcional de la instancia de extensión
<!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.
- introId: ID de una contribución de componente intro con la que se asociará esta configuración.
- id: nombre exclusivo que puede utilizarse para identificar esta configuración de introducción.
- content: un archivo de contenido de introducción. El archivo de contenido es un
archivo XML que contiene las especificidades de la introducción
(especificación de formato del archivo de contenido de
introducción).
La infraestructura de introducción analiza el archivo de contenido durante la ejecución. En función de los valores de este archivo, se muestran al usuario un determinado número de páginas, grupos y enlaces cuando se abre 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.
- home-page-id: ID de la página inicial (raíz), que es la primera página de la introducción. Esta página puede utilizarse como punto de entrada a las otras páginas principales que forman la introducción.
- standby-page-id: atributo opcional que define el ID de la página de espera. La página de espera se mostrará al usuario cuando la introducción esté establecida en standby.
<!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.
- kind: especifica el tipo de esta implementación. El tipo swt indica una implementación basada en formulario de UI, y el tipo html indica una implementación basada en navegador de SWT
- style: estilo compartido que se aplicará a todas las páginas presentadas por esta implementación de presentación de introducción.
- os: especificación de sistema operativo opcional utilizada al elegir la
implementación de la presentación. Puede ser cualquiera de los designadores definidos por Eclipse, por ejemplo, win32, linux, etc. (consulte el Javadoc de
org.eclipse.core.runtime.Platform
).
- ws: especificación de sistema de ventanas opcional utilizada al elegir la implementación de la presentación. Puede ser cualquiera de los designadores definidos por Eclipse (consulte el Javadoc de
org.eclipse.core.runtime.Platform
).
Ejemplos:
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>
Información sobre las API:
Para obtener más detalles, consulte la especificación del paquete de API org.eclipse.ui.intro.config.
Implementación suministrada:
La introducción suministrada por el conector org.eclipse.platform es la única implementación de Eclipse.
Copyright (c) 2004 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles
bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a
esta distribución, y está disponible en
http://www.eclipse.org/legal/cpl-v10.html