Eclipse中用SWT和JFace开发入门

item —— 其他控件包含的窗口小部件（该控件可能不是复合控件），比如列表和表。注意，包含一些项的控件很少包含其他控件，反之亦然。item 是一个抽象类。

　　 这些窗口小部件被安排在继承层次结构中。参见图 1、图 2 和图 3，了解它们是如何安排的。在图 2 中，basic1 类是来自本文的类，而其他所有类都是标准的 swt 窗口小部件。

图 1. swt widget 树

图 2. swt composite 树

图 3. swt item 列表

 
　　注意，eclipse 具有跨平台特性（因此可以在许多操作平台上运行），本文基于 eclipse 的 microsoft? windows? 版本。因此，本文包含的每个例子都应该能够不加任何更改地在其他平台上使用。还要注意的是，本文是基于 eclipse v3.0 的。eclipse v3.1 中添加了少许 gui 窗口小部件类型和特性。

　　基本控件

　　几乎所有 swt gui 都是从某些基础部分开始创建的。所有 swt 窗口小部件都可以在 org.eclipse.swt.widget 或 org.eclipse.swt.custom 包中找到。（一些 eclipse 插件还在其他包中提供了定制的窗口小部件。）窗口小部件包中包含一些基于操作系统控件的控件，而定制包中则包含一些超出操作系统控件集之外的控件。一些定制的软件包控件类似于窗口小部件包中的控件。为了避免命名冲突，定制控件的名称都是以“c”开始的（例如，比较 clabel 与 label）。

　　在 swt 中，所有控件（除了一些高级控件，比如 shell，将在后面进行讨论）在创建的时候都必须有一个父控件（一个复合实例）。在创建的时候，这些控件被自动“添加”到父控件中，这与必须明确添加到父控件中的 awt/swing 中的控件有所不同，自动添加产生了一种“自上而下”地构造 gui 的方法。这样，所有控件都可以采用一个复合父控件（或者一个子类）作为构造函数的参数。

　　大多数控件都有一些必须在创建时设置的标记选项。因此，大多数控件还有另外一个构造函数参数，我们通常称之为样式，该参数提供了设置这些选项的标记。所有这些参数值都是 static final int，并且都是在 org.eclipse.swt 包的 swt 类中定义的。如果不需要任何参数，则可以使用 swt.none 值。

　　标签

　　标签可能是最简单的控件，标签 被用于显示纯文本（没有颜色、特殊字体或样式的文本）或称为图标的小图像。标签不接受焦点（换句话说，用户不能通过 tab 键或鼠标移动到标签），因此，标签无法产生输入事件。

　　清单 1 展示了如何创建一个简单的文本标签。

　　清单 1. 创建一个带文本的标签

 import org.eclipse.swt.widget.*;  : composite parent = ...;  : // create a center aligned label label label = new label(parent, swt.center);   label.settext("this is the label text"); 

 import com.eclipse.swt.graphics.*; import org.eclipse.swt.widget.*; import org.eclipse.swt.custom.*;  : composite parent = ...; image image = ...;  : // create a left aligned label with an icon clabel clabel = new clabel(parent, swt.left);   label.settext("this is the imaged label text""); label.setimage(image); 

 import org.eclipse.swt.widget.*;  : composite parent = ...;  : // create a text field text name = new text(parent, swt.single);   name.settext("<none>"); name.settextlimit(50); name.settooltiptext("enter your name -- last, first");  name.selectall();  // enable fast erase 

• arrow —— 显示为一个指向上、下、左、右方向的箭头。
• check —— 已标记的复选标记。
• flat —— 没有凸起外观的按钮。
• push —— 瞬时按钮（最常见的事件源）。
• radio —— 具有排他性的粘性标记（sticky mark），其他所有单选按钮都在相同的组中。
• toggle —— 一个粘性按钮。

　　清单 4 创建了一个“clear”按钮：　　

　　清单 4. 创建一个按钮

 import org.eclipse.swt.widget.*;  : composite parent = ...;  : // create a push button button clear = new button(parent, swt.push);   clear.settext("clea&r"); 

 import org.eclipse.swt.events.*;  : // clear button pressed event handler clear.addselectionlistener(new selectionlistener() {      public void widgetelected(selectionevent e) {         system.out.println("clear pressed!");        }     public void widgetdefaultselected(selectionevent e) {         widgetelected(e);     } }); 

　　复合控件

　　至此，我们已经讨论了一些单独的控件。在多数 gui 中，许多控件被组合在一起以提供丰富的用户体验。在 swt 中，这种组合是通过 composite 类实现的。

　　复合控件可以在任何级别上进行嵌套，并且可以混合和匹配控件，将它们作为子控件进行组合。这样做可以极大地减少 gui 开发的复杂性，并为 gui 代码重用（通过封装内部 gui）创造了机会。复合控件可以是有边界的，并且这些边界很容易在视觉上产生混淆，或者它们也可以是无边界的，无缝集成到更大的组中。

　　清单 6. 创建一个有边界的复合控件。

　　单 6. 创建一个有边界的复合控件

 import org.eclipse.swt.widget.*;  : composite parent = ...;  : composite border = new composite(parent, swt.border); 

 import org.eclipse.swt.widget.*;  : composite parent = ...;  : group border = new group(parent, swt.shadow_out); border.settext("group description"); 

 import org.eclipse.swt.widget.*;  : shell frame = new shell(swt.shell_trim);  : 

 : shell dialog = new shell(frame, swt.dialog_trim);  : 

1. 绝对定位 —— 为每个控件设置明确的 x 和 y 位置，并通过代码设置一定的宽度和高度。
   
2. 托管定位 —— 每个控件的 x、y、宽度和高度都是通过layoutmanager 设置的。

　　在多数情况下，应该选择使用 layoutmanagers，因为很容易调整它们来适应可变大小的 gui。swt 也提供了一些布局管理器供您使用；在这一期的系列文章中，我们将讨论两种基本的布局管理器：filllayout 和 gridlayout。在这两种情况下，每当重新设置复合控件的大小，都需要进行定位。

　　一些布局管理器常常是专为某一个复合控件分配的。一些布局管理器只使用它们自身的参数就可以控制，而另一些布局管理器还需要其他参数 —— layoutdata，该参数是在它们管理的复合控件中的每个控件上指定的。

　　filllayout

　　filllayout 以行或列的形式安排控件。每个控件所设置的大小将与填充该复合控件所需的宽度和高度相同，在这些控件之间，空间是平均分配的。一种特殊情况是：在仅有一个子控件时，该控件的大小被设置为填充整个父复合控件的大小。

　　清单 10. 使用 filllayout 创建一列控件

 import org.eclipse.swt.widget.*; import org.eclipse.swt.layouts.*;  : composite composite = ...; filllayout filllayout = new filllayout(swt.vertical); composite.setlayout(filllayout); 

 import org.eclipse.swt.widget.*; import org.eclipse.swt.layouts.*;  : composite composite = ...; gridlayout gridlayout = new gridlayout(2, false); composite.setlayout(gridlayout); label l1 = new label(composite, swt.left); l1.settext("first name: "); text first = new text(composite, swt.single); label l1 = new label(composite, swt.left); l2.settext("last name: "); text last = new text(composite, swt.single); 

first.setlayoutdata(new griddata(swt.fill, swt.fill, true, true)); last.setlayoutdata(new griddata(swt.fill, swt.fill, true, true)); 

 import org.eclipse.swt.widget.*;  : display display = new display(); shell shell = new shell(display); shell.settext("shell title"); // *** construct shell children here *** shell.open();       // open shell for user access // process all user input events while(!shell.isdisposed()) {    // process the next event, wait when none available    if(!display.readanddispatch()) {        display.sleep();    } } display.dispose();  // must always clean up