就象任何简介部件实现一样,要使用 CustomizableIntroPart,您需要执行一些基本步骤来将其与产品绑定。但是,还需要执行一个附加的步骤才能使用这个简介部件,这个步骤就是将一个“配置”与其绑定。就象将简介与产品绑定一样,必须将 introConfig 与 customizableIntroPart 绑定。下面是一个样本配置:
<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>
在以上添加项中,向标识为 org.eclipse.ui.intro.examples.static_introId 的简介部件注册了 configuration。(这里假定这个简介部件是一个可定制的简介部件实例,并且它已向工作台注册。)这个配置定义了要在简介部件中显示的内容并指定了如何向用户显示该内容。内容是在 xml 标记文件 introContent.xml 中定义的,而表示法是由标记中的两个 implementation 元素指定的。
配置表示法可以是基于 SWT 浏览器的表示法或基于 UI 表单的表示法。在以上添加项中,表示法在 win32 平台上将是“html”,即基于浏览器,在所有其它平台上将是“swt”,即基于 UI 表单。在运行时,当工作台尝试将 CustomizableIntroPart 实例化时,便确定了操作系统并选择了表示法的正确实现。
并且,需要指定 home-page-id 或根页面,这将是 customizableIntroPart
显示的第一个页面。如果还指定了 standby-page-id,它将在简介部件处于备用方式时显示在简介部件中。
有关内容文件的详细信息可以在扩展点文档中找到。作为一个简单的示例,要添加静态内容,我们将使用以下内容:
<?xml version="1.0" encoding="UTF-8" ?> <introContent> <page id="homePageId" url="http://eclipse.org"/> <page id="standbyPageId" url="./static001/standby.html"/> </introContent>
在以上添加项中,使用了一个简单的 url 作为根页面,在本例中是指向 eclipse.org Web 站点的 url。这样做是为了降低复杂性。根页面可以是任何 HTML 文件,例如装入 Flash 演示的本地 HTML 文件。还定义了一个当简介处于备用方式时要显示的备用页面。