本文将告诉你如何在你的富客户程序中加入eclipse forms。eclipse forms可以在你的程序里不通过嵌入浏览器而达到web效果.这样可以不仅对组件保持完全控制而且不失eclipse所有的可移植性，这篇文章将从eclipse forms的基本特性到高级特性一步一步指导你。

　　历史

　　一个eclipse平台的基本特性是:所有基于eclipse平台开发的程序界面能够象本地程序一样.因为swt，菜单，窗口，树，表格，按钮和其它组件在任何操作系统上都和系统风格保持一致.作为eclipse小组最早的一个成员，我记得开发eclipse原型代码快乐的日子.菜单是真的，工具栏是真的，复选菜单，文本框，按钮，复选框，单选按钮都是真的.它们不是画出来的，都是调用的操作系统的本地组件。

　　很长一段时间里，如果你写过eclipse插件，它们基本上是属于下面的范围:

　　1.editors (编辑器)

　　2.views (视图)

　　3.wizards (向导)

　　4.dialog (窗口)

　　这个范围都有明确的规则规定了如何编写插件.我们已经看过了views里的树，表格，editors里的文档，还有简单的象在向导和窗口里的按钮和文本框。

　　eclipse 3.x里的rcp在系统上扩展了一系列新的特性，它带来了许多问题有效的解决方案，你现在可以在eclipse上构建和ide完全不同的rcp程序。

　　虽然一般的工作台部分比如视图和编辑器工作的很好，但是构成这些部分的组件(树，表格，文本编辑器等)在rcp里有时候可能不是最好的解决办法.从eclipse 3.0起，eclipse forms被设计为来提供替代的解决方案。

　　具有讽刺意味的是，我们开发出的eclipse forms解决了一个比rcp早很长时间就存在于eclipse sdk中的一个问题.使用专门编辑plugin.xml的带语法分析，颜色显示的文本编辑器的pde开发者并不高兴.eclipse的java编辑器并没有什么问题，它非常强大，对于这个任务也很理想。但是，它是用来编辑java代码的，在插件manifests里，xml是用来在更高层次上抽象描述数据结构的。手工编辑xml，即使是使用带语法分析，颜色显示的编辑器，大部分用户也觉得不太合适。在插件manifests里，语法不是重点，具体的数据和它的意思才是重点。

　　一个很好的不同例子是用html识别工具来查看标记.在代码的角度，我们可以清楚地看见含有相关属性的元素.虽然我们看到语法，但是很难看清楚它到底要表现什么.一个wysiwyg视图可以显示表格，颜色，还有一些含有表格，图片等的文本内容.在这个角度使用html文件更加具有生产效率。

　　因为语法和标记被隐藏在后台了。

　　弄明白对于html文档的wysiwyg概念很简单，因为html标签是用来展示为浏览器写一个来表现属性，超链接和图片的文本文档结构的，wysiwyg在这方面意味着在它最终的形式上编辑文档--近可能和它在浏览器上的形式相同。指出用不同的方法的一个编辑插件manifest编辑器的外观很难.最终工作小组做出了以下决定:

　　1.用最合适它的方法来展示manifest的每个部分。举个例子，象插件名称，提供者等重要信息可以简单的通过一个文本框来编辑，象扩展点定义这样带有阶层的数据结构则通过树来展现。
　　2.通过各个单独的编辑页面来展示manifest的各个部分，顺序则按照它本来在代码中的顺序。

　　3.编辑器的每个页面应该保持文档的风格，并能够容纳不同的组件，超级链接，图片，文本，并在对于页面尺寸内容太多时提供一个滚动条.

图片1：eclipse sdk1.0中的插件manifest编辑器.它容纳了swt组件，超链接和图片，并且当尺寸不够时能够滚动(就象web浏览器一样).注意为了看起来和文本内容更加融合，所有组件都是平滑的(flat).

　　第三点有效地促使了它作为现在以eclipse forms为名称的插件产生.在1.0发布后，其它的开发者希望能够复制pde多页面编辑器的富客户接口。

　　它最终作为eclipse3.0中带有公共api的插件发布了。

　　在下面的文章里，我们将告诉你什么是eclipse forms(和什么不是eclipse forms)，并如何用简单的使用它们来创造漂亮的界面。

　　eclipse forms mission

　　eclipse forms是一个贯穿所有eclipse ui的基于swt和jface的来提供可移植web风格用户界面的可选rich client插件。

　　eclipse forms打破了只能用于特定eclipse ui(编辑器，视图，向导，窗口)的模式。为了满足开发者的需要，一个eclipse form能够以任何ui的形式出现。ui开发者能够使用为他们的任务选择最合适的概念。

　　eclipse不是用来设计完全替代swt或jface的.这个插件只有一些精心挑选的专有定制组件 ，布局和支持类，以便使用swt和jface时达到预期效果.

　　很明显的，一个eclipse form通常看起来象网页一样.事实是form的纲领可行性的各方面都是使forms强大的和具有吸引力.要同过浏览器达到这样的弹性需要dom支持，并且经常几乎是聚耦的.eclipse forms是可移植的，并且是在swt和jface之上写的.

　　eclipse forms已经在3.0 release中重写来只依赖于平台ui插件，而不再依赖于pde ui插件.虽然它们还不是rcp的最小化部分，但是你能够在任何rcp程序中添加eclipse forms.

　　要点不能被低估.当构建eclipse forms时，你是在使用swt.没有eclipse forms按钮，也没有eclipse forms tree组件等等.你只是使用eclipse forms来让现有的组件达到富客户体验.

　　eclipse forms是通过下列元素来达到目的的:

　　"form"概念和视图，编辑器等是一个层次的概念.

　　一个工具包(toolkit)来管理颜色，超链接组还有其它方面.并且充当许多swt组件的工厂类.

　　一个新的layout manager来管理布局，和html表格相似.

　　一组定制的组件用来配合form.(超链接，图片超链接，滚动组合<scrollable composite>，段<section>)

　　一个各个页面都是forms的多页面编辑器(e.g. pde manifest编辑器)

　　虽然eclipse forms的设计中没有任何阻止您在一个窗口中建立form.但是大部分时候都是在视图和编辑器中使用forms，而不是窗口或向导.的确，在一个普通的窗口或向导中加入form看上去有点怪，毕竟其他部分都是普通的swt组件.无论如何，在未来，这是一个探索的方向.

　　baby steps

　　在您的用户接口中使用eclipse forms非常简单.在开始前你在插件依赖部分加入org.eclipse.ui.forms插件.我们会创建一个拥有form的

　　eclipse view，然后往里面填充内容.注意这篇文章插件的所有代码都以zip文件格式提供下载.

　　hello， eclipse forms

　　我们从往view里添加一个空白form来开始游戏:

public class formview extends viewpart { 　private formtoolkit toolkit; 　private scrolledform form; 　/** 　* the constructor. 　*/ 　public formview() {} 　/** 　* this is a callback that will allow us to create the viewer and 　* initialize it. 　*/ 　public void createpartcontrol(composite parent) { 　　toolkit = new formtoolkit(parent.getdisplay()); 　　form = toolkit.createscrolledform(parent); 　　form.settext("hello， eclipse forms"); 　} 　/** 　* passing the focus request to the form. 　*/ 　public void setfocus() { 　　form.setfocus(); 　} 　/** 　* disposes the toolkit 　*/ 　public void dispose() { 　　toolkit.dispose(); 　　super.dispose(); 　} }

　　就象你在这段代码中看到一样，不需要太多就可以创建一个form.我们开始是创建一个toolkit实例().我们通过toolkit以提供的composite为parent来创建一个可以滚动的form.我们设置了form的标题.而且我们确定在需要的时候把focus传给form，当view dispose时把toolkit也dispose掉。

　　这个视图应该看起来象这样:

图片2

　　在view里的一个空的form，使view变窄一点会让form标题包裹起来，一旦没有空间来容纳整个form，滚动条就会显示。

　　注意我们用到了可滚动的form，因为我们把它放到了一个可以改变大小的视图中.在更复杂的环境里，比如一个form需要作为一个布局的一部分，没有滚动能力的form也可以用.在这种情况下，我们会调用formtoolkit.createform()，让外层的parent来解决需要滚动条的问题。