本文档的原文在eclipse网站:http://www.eclipse.org/articles/Understanding%20Layouts/Understanding%20Layouts.htm
winion翻译整理 Copyright © 2001 Object Technology International, Inc.
摘要
采用SWT编写应用程序时,通常需要使用布局layouts来设计美观的界面。一个布局管理着在Composite上面的子组件的大小和位置。布局类是抽象类Layout的子类。本文档介绍如何使用标准布局类,以及如何编写自定义布局类。
原作者Carolyn MacLeod, OTI March 22, 2001
修订Shantha Ramachandran, OTI May 02, 2002
翻译 winion 2004.9.19
第一节 概述
1.1 布局概述
当使用标准部件库(SWT)编写应用程序时,通常需要使用通常需要使用布局layouts来设计美观的界面。一个布局管理着在Composite上面的子组件的大小和位置。SWT提供了及格标准的布局类,并且可以自定义布局类。
在SWT中,组件的位置和大小不是自动布置的。应用程序可以在初始化时计算Composite的子组件的大小和位置,也可以通过Resize监听器来调整。如果没有给定子组件的大小,那么它们的尺寸将默认为0,因而界面上显示不出来。
下图演示了几个在布局中常用的概念。一个Composite(图示是一个TabFolder)有一个位置(location)、客户区(clientArea)和修饰区(trim)。Composite的大小就是客户区大小加上修饰区大小。本例的Composite有两个子组件并列排放。Layout用来管理子组件的大小和位置,它可以定义子组件之间的距离(spacing),子组件和边界之间的空白大小(margin)。Layout的大小和Composite的客户区大小一致。
一个组件的首选的尺寸(preferred size)是显示大的内容所需的最小的尺寸。对容器而言,其大小是包含所有子组件的最小的矩形。如果子组件由应用程序放置,容器根据子组件的大小和位置来计算它的首选尺寸。如果容器使用布局类来放置子组件,它就要求Layout来计算它的客户区尺寸,然后加上修饰区,从而得出它的首选尺寸。
1.2 标准布局
SWT中的标准布局类有:
l FillLayout:以相同的大小单行或单列的排列组件;
l RowLayout:以单行或多行的方式使用fill,wrap,spacing,等选项排列组件;
l GridLayout:在格子中排列组件;
l FormLayout(SWT 2.0的新特性):通过创建组件各个边的“附件”来排列组件。
要使用标准布局类,需要引入SWT布局类包:
import org.eclipse.swt.layout.*;
布局是可插入的。要设置Composite组件的布局,使用setLayout(Layout)方法。一下代码演示了,一个Shell(Composite的子类)采用RowLayout来布局它的子组件。
Shell shell = new Shell();
shell.setLayout(new RowLayout());
一个布局类可以有一个相应的布局数据类(Object的子类),可以对指定的子控件设置具体的布局方式。为了使用方便,布局数据类的名字是通过替换布局类的Layout为Data而得到。例如,标准布局类RowLayout的布局数据类是RowData,GridLayoutt的布局数据类是GridData,FormLayout的布局数据类是FormData。以下代码演示了如何设置组件的布局数据:
Button button = new Button(shell, SWT.PUSH);
button.setLayoutData(new RowData(50, 40));
1.3 本文档使用的例子
本文档的多数屏幕截图是根据不同变量运行下面示例代码得到的。可以更改布局的类型、参数以及子组件的类型和数量:
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
import org.eclipse.swt.layout.*;
public class LayoutExample {
public static void main(String[] args) {
Display display = new Display();
Shell shell = new Shell(display);
//创建布局
RowLayout layout = new RowLayout();
// 设置可选的选项
layout.wrap = true;
// 设置到容器上
shell.setLayout(layout);
// 创建容器的子组件
new Button(shell, SWT.PUSH).setText("B1");
new Button(shell, SWT.PUSH).setText("Wide Button 2");
new Button(shell, SWT.PUSH).setText("Button 3");
shell.pack();
shell.open();
while (!shell.isDisposed()) {
if (!display.readAndDispatch()) display.sleep();
}
}
}
运行上面的代码,得到下图:
如果调整上面的界面,使右面放置不下Button 3,那么RowLayout将折行,在下一行显示Button 3,如图:
使用布局受调整大小的很大限制。因此本文档的多数例子演示了如果容器变大或变小将如何布局,以此说明布局的工作原理。
(待续)