GridLayout 是一个非常强大的布局管理器,它可以实现很多复杂的布局,名字中暗示它将所有控件放置在类似网格的布局中.^__^GridLayout 有两个构造函数.
GridLayout的构造函数
构造函数 | 描述 |
public GridLayout() | 建立一个默认的GridLayout 布局. |
public GridLayout(int numColumns, boolean makeColumnsEqualWidth) | 建立一个GridLayout 布局,拥有numColumns 列,如果makeColumnsEqualWidth 为true, 则全部组件将拥有相同的宽度. |
GridLayout 有6个公共的数据成员,相对重要的是numColumns.
GridLayout数据成员
属性 | 描述 |
int horizontalSpacing | 控制一行中两个网格间组件的宽度,像素为单位. |
boolean makeColumnsEqualWidth | 如果为true, 强制全部的列拥有相同的宽度. |
int marginHeight | 控制顶部和底部组件离边缘的距离空间,以像素为单位. |
int marginWidth | 控制左边和右边组件离边缘的距离空间,以像素为单位. |
int numColumns | 此GridLayout 的列数目. |
int verticalSpacing | 控制一列中两个网络间组件的宽度,像素为单位. |
你能使用GridLayout 设置GridData 类来布局更多的复杂组件.GridData 有两个构造函数.
GridData构造函数
构造函数 | 描述 |
public GridData() | 创建默认一个默认的GridData 对象. |
public GridData(int style) | 初始化指定的style风格布局. |
和其它的布局类一样,GridLayout 也提供一些公共的数据成员控制它的状态,它也提供一些常量,你可以在在构造成函数中使用.你可以用过位标志"|"来连接几个不同的效果,但请注意风格不要起冲突.
GridData数据成员
属性 | 描述 |
boolean grabExcessHorizontalSpace | 如果为true, 指示布局器中网格自动填充多余的水平空间,默认为false. |
boolean grabExcessVerticalSpace | 如果为true, 指示布局器中网格自动填写多余的垂直空间,默认为false. |
int heightHint | 该行中最小的高度,以像素为单位,默认为SWT.DEFAULT. |
int horizontalAlignment | 网格中组件水平对齐方式,可能的值为BEGINNING, CENTER, END, 和FILL. |
int horizontalIndent | 与左边网格的水平缩进,默认为0 |
int horizontalSpan | 设置网格占有的列数目,默认为1 |
int verticalAlignment | 网格中组件垂直对齐方式,可能的值为BEGINNING, CENTER, END, 和FILL. |
int verticalSpan | 设置网格占有的行数目,默认为1 |
int widthHint | 该列中最小的宽度,以像素为单位,默认为SWT.DEFAULT. |
常量 | 描述 |
BEGINNING | 非style 值,指定水平或垂直的对齐方式. |
CENTER | 非style 值,指定组件在网格中居中,水平或垂直. |
END | 非style 值,指定水平或垂直的对齐方式. |
FILL | 非style 值,指定组件填充网格,水平或垂直. |
FILL_BOTH | 设置horizontalAlignment 和verticalAlignment 为FILL, 设置grabExcessHorizontalSpace 和grabExcessVerticalSpace为true. |
FILL_HORIZONTAL | 设置horizontalAlignment 为FILL, 和设置grabExcessHorizontalSpace 为true. |
FILL_VERTICAL | 设置verticalAlignment 为FILL, 和设置grabExcessVerticalSpace 为true. |
GRAB_HORIZONTAL | 设置grabExcessHorizontalSpace 为true. |
GRAB_VERTICAL | 设置grabExcessVerticalSpace 为true. |
HORIZONTAL_ALIGN_BEGINNING | 设置horizontalAlignment 为BEGINNING. |
HORIZONTAL_ALIGN_CENTER | 设置horizontalAlignment 为CENTER. |
HORIZONTAL_ALIGN_END | 设置horizontalAlignment 为END. |
HORIZONTAL_ALIGN_FILL | 设置horizontalAlignment 为FILL. |
VERTICAL_ALIGN_BEGINNING | 设置verticalAlignment 为BEGINNING. |
VERTICAL_ALIGN_CENTER | 设置verticalAlignment 为CENTER. |
VERTICAL_ALIGN_END | 设置verticalAlignment 为END. |
VERTICAL_ALIGN_FILL | 设置verticalAlignment 为FILL. |
下面我们来看几个例子: |
代码片段: GridLayout gridLayout = new GridLayout();
gridLayout.numColumns = 2;
shell.setLayout(gridLayout);
new Button(shell, SWT.PUSH).setText("one");
new Button(shell, SWT.PUSH).setText("two");
new Button(shell, SWT.PUSH).setText("three");
new Button(shell, SWT.PUSH).setText("four");
运行效果:
|
图中可以看到各个Button 的宽度是依靠字体长度来自动设定的,假如你想设置所有的Button 都使用相同的大小该怎么办?使用makeColumnsEqualWidth = true; 吗?不,这样做不行,它回会将各网格的大小设为相同,我们该使用GridData 中相关属性来设置Button. 下面程序中使用了GridData.FILL_BOTH 属性,它将填充所在网格水平或垂直空间,并将多余空间占有,这样不论窗口调整多大,四个Button 都会有相同空间.
当然GridLayout能做的不只是这些,要更复杂的效果,可能多个Composite 配合使用,具体请参见原书第二部分第四章:Apress.The.Definitive.Guide.to.SWT.and.JFace.eBook-LiB.chm
运行效果
初始化:
调整大小后:
完整代码:
package chapter4; import org.eclipse.swt.SWT; import org.eclipse.swt.layout.GridData; import org.eclipse.swt.layout.GridLayout; import org.eclipse.swt.widgets.Button; import org.eclipse.swt.widgets.Display; import org.eclipse.swt.widgets.Shell; /* * * @author HexUzHoNG Created on 2005-6-23 * */ public class GridLayoutDemo { public static void main(String[] args) { Display display = new Display(); Shell shell = new Shell(display); GridLayout gridLayout = new GridLayout(); // 设置为2列 gridLayout.numColumns = 2 ; gridLayout.makeColumnsEqualWidth = true ; shell.setLayout(gridLayout); GridData gd = new GridData(GridData.FILL_BOTH); Button butOne = new Button(shell, SWT.PUSH); butOne.setText( " one " ); butOne.setLayoutData(gd); gd = new GridData(GridData.FILL_BOTH); Button butTwo = new Button(shell, SWT.PUSH); butTwo.setText( " two " ); butTwo.setLayoutData(gd); gd = new GridData(GridData.FILL_BOTH); Button butThree = new Button(shell, SWT.PUSH); butThree.setText( " three " ); butThree.setLayoutData(gd); gd = new GridData(GridData.FILL_BOTH); Button butFour = new Button(shell, SWT.PUSH); butFour.setText( " four " ); butFour.setLayoutData(gd); shell.pack(); shell.open(); while ( ! shell.isDisposed()) { if ( ! display.readAndDispatch()) { display.sleep(); } } display.dispose(); } }