Como cualquier implementación de un componente intro, para utilizar un CustomizableIntroPart tiene que seguir los pasos básicos para enlazarlo a un producto. No obstante, hay un paso adicional que es preciso para utilizar este componente intro y que consiste en enlazar una "configuración" al mismo. Igual que se enlaza una introducción a un producto, debe enlazar un introConfig a un customizableIntroPart. Esta es una configuración de ejemplo:
<extension point="org.eclipse.ui.intro.config"> <config id = "static001_configId" introId="org.eclipse.ui.intro.examples.static_introId" content="introContent.xml"> <presentation home-page-id="homePageId" standby-page-id="standbyPageId"> <implementation os="win32" kind="html" /> <implementation kind="swt" /> </presentation> </config> </extension>
En la contribución anterior, se registra configuration con un componente intro que tiene el ID org.eclipse.ui.intro.examples.static_introId. (Se supone que este componente intro es una instancia de componente intro personalizable que ya se ha registrado en el entorno de trabajo). Esta configuración define el contenido que se presentará en el componente intro y dicta cómo se presentará al usuario. El contenido se define en un archivo de códigos xml, introContent.xml, mientras que la presentación la dictan dos elementos implementation del código.
Una presentación de configuración puede ser una presentación basada en
navegador SWT o basada en formularios de UI.
En la contribución anterior, la presentación será "html", es decir, basada
en navegador de plataformas win32, mientras que será "swt", o sea, basada en
formularios de UI en todas las demás plataformas.
En el entorno de ejecución, cuando el entorno de trabajo intente crear la
instancia de
CustomizableIntroPart, se determinará el sistema operativo y se elegirá la
implementación correcta de la presentación.
Además, es preciso especificar una página de raíz home-page-id , ya
que será la primera página visualizada por customizableIntroPart. Si también se
especifica standby-page-id, se visualizará en el componente intro
cuando éste se ponga en la modalidad de espera.
Los detalles acerca del archivo de contenido pueden encontrarse en la documentación del punto de extensión. Para ver un ejemplo simple y contribuir al contenido estático, utilizaremos lo siguiente como contenido:
<?xml version="1.0" encoding="UTF-8" ?> <introContent> <page id="homePageId" url="http://eclipse.org"/> <page id="standbyPageId" url="./static001/standby.html"/> </introContent>
En la contribución anterior, un URL simple se utiliza como página raíz, en este caso es un URL que apunta al sitio web eclipse.org. Se ha hecho así para simplificar. La página raíz podría ser cualquier archivo HTML, por ejemplo, un archivo HTML local que cargue una demostración flash. También hay una página de espera definida que se mostrará cuando la introducción se ponga en la modalidad de espera.