KTable的简单使用方法

 如果您需要一种大容量（万行级别）的可编辑报表表格控件，那么KTable将是最佳选择。KTable 是一个用java开发的,对控制报表的项目,它最大的特点是使用独特的算法,能支持巨大的报表。

一、概述

KTable是一种表格式的SWT控件，作者Friederich Kupzog和Lorenz Maierhofer。主要功能：

1.         用户自定义界面风格

2.         可编辑数据

3.         可合并单元格，改变行高列宽

4.   提供颜色选择器

5.   添加图片等

KTable的直接父类是Canvas。请看层次结构：

   

二、使用KTable

1.创建KTable

publicstaticvoid main(String[] args)

    {

        // 创建shell

        Display display = new Display();

        Shell shell = new Shell(display);

        shell.setLayout(new FillLayout());

        shell.setText("KTable examples");

 

        // 创建选项卡

        TabFolder tabFolder = new TabFolder(shell, SWT.NONE);

        TabItem item = new TabItem(tabFolder, SWT.NONE);

        item.setText("Text Table");

        Composite comp = new Composite(tabFolder, SWT.NONE);

        item.setControl(comp);

        comp.setLayout(new FillLayout());

 

        KTable table = new KTable(comp, SWT.FULL_SELECTION | SWT.MULTI | SWT.V_SCROLL | SWT.H_SCROLL

                | SWTX.FILL_WITH_LASTCOL | SWTX.EDIT_ON_KEY);

        table.setModel(new Object());

        shell.setSize(600, 600);

        shell.open();

        while (!shell.isDisposed())

        {

            if (!display.readAndDispatch())

                display.sleep();

        }

        display.dispose();

    }

创建完KTable后需要给KTable定义一个数据模型用公共方法setModel(KTableModel model)。才能显示数据，否则异常。

2.设置报表数据

KTable中有几种作者约定好的Model。当前我们用默认model。

class WKTableModel extends KTableDefaultModel

{

    // 设置标题字体

    privatefinal FixedCellRenderer m_fixedRenderer = new FixedCellRenderer(FixedCellRenderer.STYLE_FLAT

            | TextCellRenderer.INDICATION_FOCUS_ROW);

    // 设置单元格字体

    privatefinal TextCellRenderer m_textRenderer = new TextCellRenderer(TextCellRenderer.INDICATION_FOCUS_ROW);

    // 定义一个容器

    private HashMap content = new HashMap();

    // 构造方法

    public WKTableModel ()

    {

        initialize();

        m_textRenderer.setForeground(Display.getCurrent().getSystemColor(SWT.COLOR_DARK_GREEN));

    }

 

    // 显示数据

    public Object doGetContentAt(int col, int row)

    {

        String s = (String)content.get(col + "/" + row);

        if (s != null)

            return s;

        return col + "/" + row;

    }

 

    // 设置单元格字体样式

    public KTableCellRenderer doGetCellRenderer(int col, int row)

    {

        if (isFixedCell(col, row))

            returnm_fixedRenderer;

 

        returnm_textRenderer;

    }

 

    // 表格行数

    publicint doGetRowCount()

    {

        return 100000;

    }

 

    // 标题行数

    publicint getFixedHeaderRowCount()

    {

        return 1;

    }

 

    // 表格列数

    publicint doGetColumnCount()

    {

        return 10000;

    }

 

    // 标题列数

    publicint getFixedHeaderColumnCount()

    {

        return 1;

    }

 

    // 列宽

    publicint getInitialColumnWidth(int column)

    {

        return 90;

    }

 

    // 行高

    publicint getInitialRowHeight(int row)

    {

        if (row == 0)

            return 22;

        return 18;

    }

}

运行结果：

 

如果您需要把修改的数据记录下来，那么需要用到公共方法：doSetContentAt(int column, int row, Object value)。

    // 记录修改数据

    publicvoid doSetContentAt(int col, int row, Object value)

    {

        content.put(col + "/" + row, value);

}

3.设计表格风格

这节将教大家几种KTable方便的设置表格风格的方法，装饰一下自己的表格。

1）.单元格样式—下拉框可编辑

public KTableCellEditor doGetCellEditor(int column, int row)

    {

        if (column < getFixedColumnCount() || row < getFixedRowCount())

            returnnull;

        if (column % 3 == 1)

        {

            KTableCellEditorCombo combo = new KTableCellEditorCombo();

            combo.setItems(new String[]{"First", "Second", "third"});

            return combo;

        }

        elseif (column % 3 == 2)

        {

            KTableCellEditorComboText comboText = new KTableCellEditorComboText();

            comboText.setItems(new String[]{"选择一", "选择二", "选择三"});

            return comboText;

        }

        else

        {

            returnnew KTableCellEditorText();

        }

    }

控件：

KtableCellEditorCombo：只允许选择，不能输入。

KTableCellEditorComboText：允许选择和重新输入。

KTableCellEditorText：相当于文本框。

除了上面的三种，KTable还提供几种单元格控件：

KTableCellEditorCheckbox：选择框。如：

KTableCellEditorMultilineText：多行输入文本框。

2）.改变行列大小

如果您需要改变单元格大小，在Model中加上下面2个公共方法即可：

publicboolean isColumnResizable(int col)

    {

        returntrue;

    }

 

    publicboolean isRowResizable(int row)

    {

        returntrue;

    }

3）.合并单元格

在Model中加上下面代码，具体格式可自己定义，我是两两合并：

public Point doBelongsToCell(int col, int row)

    {

        if (isFixedCell(col, row))

            returnnew Point(col, row);

 

        col -= getFixedHeaderColumnCount() + getFixedSelectableColumnCount();

        row -= getFixedHeaderRowCount() + getFixedSelectableRowCount();

 

        if ((col == 1 && row == 1) && (col % 2 == 0 && row % 2 == 0))

            returnnew Point(col, row);

 

        // find supercell to merge with:

        int newCol = col;

        int newRow = row;

        if (col % 2 != 0)

            newCol--;

        if (row % 2 != 0)

            newRow--;

 

        returnnew Point(newCol + getFixedHeaderColumnCount() + getFixedSelectableColumnCount(), newRow

                + getFixedHeaderRowCount() + getFixedSelectableRowCount());

    }

4）.显示tooltip

public String doGetTooltipAt(int column, int row)

{

        return "Test-Tooltip";

    }

5）.添加图片

添加图片其实很简单只要在公共方法doGetContentAt ()中把图片对象返回就行了。其他的不用管了。因为doGetContentAt ()的返回类型是Object，所以可以返回任何对象。不过要记得把单元格大小调整好。

4.给表格添加排序功能

像windows的文件夹的排序功能一样，KTable的排序功能也是：单击标题自动切换上、下排序。

我们需要给表格添加KTableCellSelectionListener监听器。并且KTable的Model需要继承KTableSortedModel。

table.addCellSelectionListener(new KTableSortOnClick(table,

        new SortComparatorExample(model,

        -1, KTableSortComparator.SORT_NONE)));

简单介绍一下排序器的构造方法的三个参数，SortComparatorExample(KTableSortedModel model, int columnIndex,int direction)。

model：当前比表格使用的模型，用于对数据进行操作。

columnIndex：排序的列号。

Direction：升降排序标志，有三种：SORT_UP，SORT_DOWN，SORT_NONE。