遍历单元格 FineReport帮助文档|报表开发|报表使用|学习教程

历史版本20 :遍历单元格返回文档

编辑时间:09-11 11:34 历史版本: 最新历史版本上一篇历史版本下一篇历史版本 内容长度:3866 图片数:3目录数:3 修改原因:增加内链

1. 描述
2. 原理
3. 示例

1. 描述编辑

使用场景：有时候我们需要对报表每个单元格进行处理，如何在程序中遍历单元格呢？

功能介绍：FineReport 中通过 Report的cellIterator() 方法获取 Report 中所有的单元格，这些单元格放在 Iterator 中，可以像遍历普通的 Iterator 对象一样遍历 Iterator 中的单元格，从而对单元格进行处理或作其他操作。

根据需要您可以遍历所有单元格或者仅对部分单元格进行遍历，遍历方法我们在该文档中会一一说明，最后通过一个实际应用来展示遍历单元格的功效。

2. 原理编辑

2.1 获取报表

遍历单元格前我们需要获取单元格所在的容器 Report，我们以 Group.cpt 为例，如下所示：

// 读取模板保存为WorkBook对象  
workbook = TemplateWorkBookIO.readTemplateWorkBook("/doc/Primary/GroupReport/Group.cpt");

2.2 遍历单元格

// 遍历单元格  
int col = 0, row = 0;
byte direction = 0;
java.util.Iterator it = report.cellIterator();
while (it.hasNext()) {
    TemplateCellElement cell = (TemplateCellElement) it.next();
    // 获取单元格的行号与列号并互换  
    col = cell.getColumn();
    row = cell.getRow();
    cell.setColumn(row);
    cell.setRow(col);
    // 获取原单元格的扩展方向，0表示纵向扩展，1表示横向扩展  
    direction = cell.getCellExpandAttr().getDirection();
    if (direction == 0) {
        cell.getCellExpandAttr().setDirection((byte) 1);
    } else if (direction == 1) {
        cell.getCellExpandAttr().setDirection((byte) 0);
    }
    // 将改变后的单元格添加进新的WorkSheet中  
    newworksheet.addCellElement(cell);
}