SWT里的表格编程(翻译)

//原文摘自《The Definitive Guide to SWT and JFace》
Tables
SWT使用Table、TableColumn和TableItem这3个独立的类来构建table.
这3个类都不需要被继承.

*****Creating Tables

Table类只提供了一个构造方法:
public Table(Composite parent, int style)

下表显示了style的作用,在构造方法中允许用逻辑与操作符表示style.
Style Description
SWT.SINGLE 一次只能选择一行,默认的参数.
SWT.MULTI 一次能选择多行,一般是使用Ctrl+鼠标实现选择多行.
SWT.CHECK 将放置一个checkbox在每行的最开头处.注意checkbox
的选择状态与表格行是否处于被选择的状态无关.
SWT.FULL_SELECTION 当表格行被选择时,高亮显示,而不是默认的只显示第一列.
SWT.HIDE_SELECTIN 当表格所在的窗口不是当前的窗口时,除去被选择行的高亮
显示.默认的是无论表格所在窗口是否为当前窗口都使被选
择行处于高亮显示.

*****Adding Columns

TableColumn类表示表格里的一列,你创建一列使用一个parent table, a style
,和一个可选的index.如果你不设置index,那么这列就将被默认把index设置为0.

TableColumn的构造方法:
public TableColumn(Table parent, int style)
public TableColumn(Table parent, int style, int index)

所有设置表格列的内容的对齐参数有:
SWT.LEFT 左对齐
SWT.CENTER 居中
SWT.RIGHT 右对齐

只能设置其中一个参数,如果设置了多于一个参数，后果将不确定.可以在构造方法后改
变对齐:通过setAlignment()方法.默认对齐是左对齐并且影响在这列中所有的行.
表格列能够显示标题.每个标题只能显示一行,它将按照ASC2码显示字符.
parent table可以通过setHeadersVisible()方法控制标题是否显示.

*****Adding Rows

构造方法:
TableItem(Table parent, int style)
TableItem(Table parent, int style, int index)

使用第2个参数在表格中插入行,将已经存在的行往后移,如果传入的参数超过范围就抛
出IllegalArgumentException.比如,如果没有行存在与table中,这样写的话:
new TableItem(table, SWT.NONE, 1);
结果如下:
java.lang.IllegalArgumentException: Index out of bounds
没有style提供给TableItem,所以你必须经常传递SWT.NONE参数以忽略其它值.
你可以改变TableItem的前景颜色和背景颜色,以整行宽或者一个单元格宽都可以.单
元格能够显示文字,图片,或者两者都显示.如果你两者都设置了,图片将显示在文字的左
方.

*****示例程序:
import org.eclipse.swt.*;
import org.eclipse.swt.graphics.Font;
import org.eclipse.swt.graphics.Color;
import org.eclipse.swt.layout.*;
import org.eclipse.swt.widgets.*;

/**
* Displays ASCII Codes
*/
public class AsciiTable {
// The number of characters to show.
private static final int MAX_CHARS = 128;
// Names for each of the columns
private static final String[] COLUMN_NAMES = { "Char", "Dec", "Hex", "Oct",
"Bin", "Name"};

// The names of the first 32 characters
private static final String[] CHAR_NAMES = { "NUL", "SOH", "STX", "ETX", "EOT",
"ENQ", "ACK", "BEL", "BS", "TAB", "LF", "VT", "FF", "CR", "SO", "SI",
"DLE", "DC1", "DC2", "DC3", "DC4", "NAK", "SYN", "ETB", "CAN", "EM", "SUB",
"ESC", "FS", "GS", "RS", "US", "Space"};

// The font to use for displaying characters
private Font font;

// The background colors to use for the rows
private Color[] colors = new Color[MAX_CHARS];

/**
* Runs the application
*/
public void run() {
Display display = new Display();
Shell shell = new Shell(display);
shell.setText("ASCII Codes");
createContents(shell);
shell.pack();
shell.open();
while (!shell.isDisposed()) {
if (!display.readAndDispatch()) {
display.sleep();
}
}
// Call dispose to dispose any resources
// we have created
dispose();
display.dispose();
}

/**
* Disposes the resources created
*/
private void dispose() {
// We created this font; we must dispose it
if (font != null) {
font.dispose();
}

// We created the colors; we must dispose them
for (int i = 0, n = colors.length; i < n; i++) {
if (colors[i] != null) {
colors[i].dispose();
}
}
}

/**
* Creates the font
*/
private void createFont() {
// Create a font that will display the range
// of characters. "Terminal" works well in
// Windows
font = new Font(Display.getCurrent(), "Terminal", 10, SWT.NORMAL);
}

/**
* Creates the columns for the table
*
* @param table the table
* @return TableColumn[]
*/
private TableColumn[] createColumns(Table table) {
TableColumn[] columns = new TableColumn[COLUMN_NAMES.length];
for (int i = 0, n = columns.length; i < n; i++) {
// Create the TableColumn with right alignment
columns[i] = new TableColumn(table, SWT.RIGHT);

// This text will appear in the column header
columns[i].setText(COLUMN_NAMES[i]);
}
return columns;
}

/**
* Creates the window's contents (the table)
*
* @param composite the parent composite
*/
private void createContents(Composite composite) {
composite.setLayout(new FillLayout());

// The system font will not display the lower 32
// characters, so create one that will
createFont();

// Create a table with visible headers
// and lines, and set the font that we
// created
Table table = new Table(composite, SWT.SINGLE | SWT.FULL_SELECTION);
table.setHeaderVisible(true);
table.setLinesVisible(true);
table.setRedraw(false);
table.setFont(font);

// Create the columns
TableColumn[] columns = createColumns(table);

for (int i = 0; i < MAX_CHARS; i++) {
// Create a background color for this row
colors[i] = new Color(table.getDisplay(), 255 - i, 127 + i, i);

// Create the row in the table by creating
// a TableItem and setting text for each
// column
int c = 0;
TableItem item = new TableItem(table, SWT.NONE);
item.setText(c++, String.valueOf((char) i));
item.setText(c++, String.valueOf(i));
item.setText(c++, Integer.toHexString(i).toUpperCase());
item.setText(c++, Integer.toOctalString(i));
item.setText(c++, Integer.toBinaryString(i));
item.setText(c++, i < CHAR_NAMES.length ? CHAR_NAMES[i] : "");
item.setBackground(colors[i]);
}

// Now that we've set the text into the columns,
// we call pack() on each one to size it to the
// contents
for (int i = 0, n = columns.length; i < n; i++) {
columns[i].pack();
}

// Set redraw back to true so that the table
// will paint appropriately
table.setRedraw(true);
}

/**
* The application entry point
*
* @param args the command line arguments
*/
public static void main(String[] args) {
new AsciiTable().run();
}
}
*****Sorting Tables
用户希望能通过点击表格标题使每行按照列排序,以升序或者降序交替.SWT表格不会自动
做这些事,但是可以通过编程实现,要实现排序,你可以按照下面的步骤:
1.为列标题栏增加一个listener,这样可以侦察到标题栏被鼠标点击.
2.取得现在要排序的信息.(按哪一列排序,按哪个方向排序--升序或降序)
3.对数据进行排序并且重新显示.

*****小结
如果你是一个Swing develloper,你一定会取笑SWT表格这种排序方法:取得数据,排序,
然后重新填入.用SWT编程意味着在widget level上,使用data(model),view,并且意
味着view和controller不可分割.象Swing的表格那样将data和view分离,并且用MVC
模式使用controller,使表格排序更加直接.
但是记住虽然SWT是在widget的level上,但是JFace提供了一个在SWT之上的MVC层次编
程,从而使在JFace中编程变得象Swing一样简单.