简介部分配置

org.eclipse.ui.intro.config

3.0

此扩展点用来注册简介配置。此配置为给定简介添加项提供表示实现和内容。简介将在第一次启动工作台时出现并作为“帮助”菜单中的一个选项。简介通常用于向用户介绍在 Eclipse 上构建的产品。

简介分成若干页,通常会反映特殊类别的介绍性资料。例如,“新增内容”可能会介绍自先前版本以来新增的概念或功能。可使用 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>

可用来配置可定制简介部分的配置元素。配置元素必须指定标识、简介标识和内容文件。简介内容文件是描述简介所具有的页面、组和链接的 XML 文件。



<!ELEMENT presentation (implementation+)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

定义简介部分的表示的所有可能实现的表示元素。它可能定义了一个或多个实现。根据实现的 os/ws 属性,启动时只会有一个实现被选中。否则,没有定义 os/ws 属性的第一项将会被选中。



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

平台的现成经验的表示具有两个实现。其中一项是基于 SWT 浏览器的,而另一项是基于用户界面表单的。可配置可定制简介部分以便根据当前操作系统和窗口系统选择这两个表示的其中一个。实现的类型可以是 SWT 或 HTML。



以下是配置扩展点的样本用法。

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

有关进一步的详细信息,请参阅 org.eclipse.ui.intro.config API 包的细节。

org.eclipse.platform plugin 提供的简介是 Eclipse 中的唯一实现。