Eclipse中用SWT和JFace开发入门

可以使用标准窗口小部件工具箱（Standard Widget ToolkitSWT）和 JFace 库来开发用于 Eclipse 环境的图形用户界面而且还可以将它们用于开发单独的 GUI 本机应用程序在本文中我将介绍一些基本的 SWT（基本 GUI 对象的名称）类型并展示如何综合使用它们来创建有用的应用程序

关于 EclipseSWT 和 JFace

正如 Eclipse 的 Web 站点上所提到的Eclipse 是一种通用工具平台它是一个开放的可用于任何东西的可扩展 IDE没什么特别之处它为工具开发人员提供了灵活性以及对软件技术的控制

Eclipse 为开发人员提供了生产大量 GUI 驱动的工具和应用程序的基础而这项功能的基础就是 GUI 库 SWT 和 JFace

SWT 是一个库它创建了Java 版的本地主机操作系统 GUI 控件它依赖于本机实现这意味着基于 SWT 的应用程序具有以下几个关键特性

它们的外观行为和执行类似于本机应用程序

所提供的窗口小部件（widget）反映了主机操作系统上提供的窗口小部件（组件和控件）

主机 GUI 库的任何特殊行为都在 SWT GUI 中得到反映

这些目标使得 SWT 不同于 Java 技术的 SwingSwing 的设计目标是消除操作系统的差异

SWT 库反映了主机操作系统的基本窗口小部件在许多环境下这种方法太低级JFace 库有助于向 SWT 应用程序中添加大量服务JFace 并没有隐藏 SWT它只是扩展了 SWT正如您将在这一系列的后面部分中看到的SWT 最重要的扩展之一是将应用程序的数据模型与显示及更改它的 GUI 隔离开来

在开始之前我需要介绍一些 SWT 术语

Widget —— 基本的 SWT GUI 组件（类似于 Java AWT 中的 Component 和 Swing 中的 JComponent）Widget 是一个抽象类

Control —— 拥有操作系统的对等物的窗口小部件（换句话说在操作系统中具有同一身份）Control 是一个抽象类

Composite —— 包含其他控件的控件（类似于 Java AWT 中的 Container 和 Swing 中的 JPanel）

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

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

图 SWT Widget 树

图 SWT Composite 树

图 SWT Item 列表

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

基本控件

几乎所有 SWT GUI 都是从某些基础部分开始创建的所有 SWT 窗口小部件都可以在 orgeclipseswtwidget 或 orgeclipseswtcustom 包中找到（一些 Eclipse 插件还在其他包中提供了定制的窗口小部件）窗口小部件包中包含一些基于操作系统控件的控件而定制包中则包含一些超出操作系统控件集之外的控件一些定制的软件包控件类似于窗口小部件包中的控件为了避免命名沖突定制控件的名称都是以C开始的（例如比较 CLabel 与 Label）

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

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

标签

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

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

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

import orgeclipseswtwidget*;

:

Composite parent = ;

:

// create a center aligned label

Label label = new Label(parent SWTCENTER);

labelsetText(This is the label text);

注意该文本是采用不同于构造函数的单独的方法设置的这是所有 SWT 控件的一个典型象征只有父控件和样式是在构造函数中设置的其他所有属性都是在已创建的对象上设置的

由于平台的限制标准标签控件不能同时拥有文本和图标为了支持同时拥有文本和图标可以使用 CLabel 控件如清单 中所示

清单 创建一个包含文本和图像的标签

import comeclipseswtgraphics*;

import orgeclipseswtwidget*;

import orgeclipseswtcustom*;

:

Composite parent = ;

Image image = ;

:

// create a left aligned label with an icon

CLabel Clabel = new CLabel(parent SWTLEFT);

labelsetText(This is the imaged label text);

labelsetImage(image);

文本

在标签显示文本的同时您时常还想允许用户插入文本文本 控件就是用于此目的的文本可以是单行的（一个文本字段）也可以是多行的（一个文本区域）文本还可以是只读的文本字段中没有描述因此常常通过标签控件处理它们以确定它们的用途文本控件还可以包含一个工具提示提供关于控件用途的信息（所有控件都支持这一特性）

清单 显示了如何使用允许使用的有限数量的特性来创建一个简单的文本字段选择默认文本是为了便于擦除

清单 创建一个包含选定的默认文本和一个限制条件的文本

import orgeclipseswtwidget*;

:

Composite parent = ;

:

// create a text field

Text name = new Text(parent SWTSINGLE);

namesetText(<none>);

namesetTextLimit();

namesetToolTipText(Enter your name Last First);

nameselectAll();// enable fast erase

按钮

通常您希望用户指出应该何时进行某项操作最常见的做法是使用按钮 控件存在以下几种样式的按钮

ARROW —— 显示为一个指向上下左右方向的箭头

CHECK —— 已标记的复选标记

FLAT —— 没有凸起外观的按钮

PUSH —— 瞬时按钮（最常见的事件源）

RADIO —— 具有排他性的粘性标记（sticky mark）其他所有单选按钮都在相同的组中

TOGGLE —— 一个粘性按钮

清单 创建了一个Clear按钮

清单 创建一个按钮

import orgeclipseswtwidget*;

:

Composite parent = ;

:

// create a push button

Button clear = new Button(parent SWTPUSH);

clearsetText(Clea&r);

名称中的 & 导致利用紧接着的一个字母创建一个加速器允许通过 Ctrl+<字母> 顺序的方式按下按钮（控件顺序由主机操作系统决定）

事件监听器

通常您可能想在选择按钮（特别是某种推式按钮）的时候执行一些操作您可以通过向该按钮添加一个 SelectionListener（在 orgeclipseswtevents 包中）做到这一点当按钮状态发生改变时（通常是按钮被按下）就会生成事件清单 在单击 Clear 按钮时输出一条消息

清单 按钮事件处理程序

import orgeclipseswtevents*;

:

// Clear button pressed event handler

clearaddSelectionListener(new SelectionListener() {

public void widgetelected(selectionEvent e) {

Systemoutprintln(Clear pressed!);

}

public void widgetDefaultSelected(selectionEvent e) {

widgetelected(e);

}

});

此代码使用了一个匿名的内部类但您还可以使用指定的内部类或单独的类作为监听器多数包含两个或更多方法的 Listener 类还有一个类似的 Adapter 类这个类提供了一些空的方法实现并且可以减少您需要编写的代码数量例如还有一个 SelectionAdapter 类这个类实现了 SelectionListener

注意在这些方法中执行的操作必须快速完成（通常不足一秒时间）或者说 GUI 的反应将是迟钝的更长时间的操作（比如访问文件）需要单独的线程但那是以后某期文章的主题

复合控件

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

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

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

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

import orgeclipseswtwidget*; : Composite parent = ; : Composite border = new Composite(parent SWTBORDER);

除了边界之外Group 复合子类还支持标题在定义排他性按钮集合时组通常被用来包含单选类型的按钮

清单 创建了一个有边界的组

清单 创建一个有边界的组

import orgeclipseswtwidget*; : Composite parent = ; : Group border = new Group(parent SWTSHADOW_OUT); bordersetText(Group Description);

shell

shell 是一种可能没有父复合控件的复合控件（框架或窗口）此外它还有一个作为父控件的 Display这通常也是默认设置shell 有很多种样式但最常见的样式是 SWTSHELL_TRIM 或 SWTDIALOG_TRIMshell 可以是模态的也可以是非模态的模态 shell 常常用于对话框防止父 GUI（如果有的话）在关闭子 shell 之前被处理

清单 创建了一个框架样式的顶级非模态 shell

清单 创建一个顶级 shell

import orgeclipseswtwidget*; : Shell frame = new Shell(SWTSHELL_TRIM); :

shell 可以有子 shell这些子 shell 是与父 shell 相关的独立桌面窗口（也就是说如果父 shell 关闭那么其所有子 shell 也将关闭）

清单 创建了一个对话框样式的子 shell

清单 创建一个对话框 shell

: Shell dialog = new Shell(frame SWTDIALOG_TRIM); :

参见图 中具有 SWTSHELL_TRIMSee 的 shell以及图 中具有 SWTDIALOG_TRIM 的 shell了解这些值如何影响 shell 的整洁性

图 具有 SWTSHELL_TRIM 的 shell

图 具有 SWTDIALOG_TRIM 的 shell

布局管理器

复合控件常常包含多个控件可以使用以下两种方法安排这些控件

绝对定位 —— 为每个控件设置明确的 X 和 Y 位置并通过代码设置一定的宽度和高度

托管定位 —— 每个控件的 XY宽度和高度都是通过LayoutManager 设置的

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

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

FillLayout

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

清单 使用 FillLayout 创建一列控件

import orgeclipseswtwidget*; import orgeclipseswtlayouts*; : Composite composite = ; FillLayout fillLayout = new FillLayout(SWTVERTICAL); compositesetLayout(fillLayout);

GridLayout

GridLayout 提供了一个功能更强大的布局方法该方法类似于使用 HTML 表的方法它创建了 D 网格的单元格可以将控件放置在一个或多个单元格中（可以称之为单元格跨越）单元格的大小可以是相等的或者是网格宽度或高度的某个给定可变百分比可以将控件添加到某一行的下一个可用列中如果这一行中没有更多的列那么该控件将移动到下一行的第一列中

清单 创建了一个复合控件该控件有两行和两个列其中包含两个已标记的文本字段这些列可以有不同的宽度

清单 创建一个控件表

import orgeclipseswtwidget*; import orgeclipseswtlayouts*; : Composite composite = ; GridLayout gridLayout = new GridLayout( false); compositesetLayout(gridLayout); Label l = new Label(composite SWTLEFT); lsettext(First Name: ); Text first = new Text(composite SWTSINGLE); Label l = new Label(composite SWTLEFT); lsetText(Last Name: ); Text last = new Text(composite SWTSINGLE);

GridData

考虑一下这种情况您需要指定每个控件如何使用其单元格中的剩余空间为了给每个单元格提供这种精确控制添加到 GridLayout 的托管复合控件的控件可以拥有 GridData 实例（LayoutData 的子类）

清单 设置了这些文本字段以便采用所有可用的剩余空间（根据前面的清单）

清单 配置一个扩展到所有可用空间的布局

firstsetLayoutData(new GridData(SWTFILL SWTFILL true true)); lastsetLayoutData(new GridData(SWTFILL SWTFILL true true));

构建一个运行程序

现在是时候来看一下我们已经在简单的可执行例子 Basic 中讨论过的所有 SWT 控件了请参阅 参考资料以获得该应用程序的完整源代码

SWT GUI 需要一个已配置好的环境来运行这个环境是通过一个显示实例提供的该实例提供了对主机操作系统显示设备的访问这个显示实例允许您处理每个用户输入（鼠标或键盘）来处理您的 GUI

清单 创建了一个环境和一个 GUI并显示了这个 GUI

清单 创建一个 GUI 应用程序并启动它

import orgeclipseswtwidget*; : Display display = new Display(); Shell shell = new Shell(display); shellsetText(Shell Title); // *** construct Shell children here *** shellopen(); // open shell for user access // process all user input events while(!shellisDisposed()) { // process the next event wait when none available if(!displayreadAndDispatch()) { displaysleep(); } } displaydispose(); // must always clean up

此代码创建了一个类似于图 的窗口

图 示例应用程序

结束语

在 SWT 和 JFace 系列的第一期中我们介绍了大多数基本 SWT 窗口小部件控件标签文本按钮复合控件和 shell这些控件与显示类（display class）相结合允许创建全功能的 GUI