概述 | 软件包 | 类 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

## application.workbooks.workbook.tables
类 Cells

    java.lang.Object
      application.workbooks.workbook.tables.Cells

    public class Cells

extends java.lang.Object

代表指定单元格的一个集合，这个集合是一个连续范围的单元格区域。可以从行对象、列对象或表格中得到此集合。

方法摘要
`Cell` | `addCell(Cell beforeCell, int shiftCells)` 在指定的单元格插入新的单元格。
`Cells` | `addCells(int shiftCells)` 根据当前指定的单元格区域插入新的单元格。
`void` | `averageColumnWidth()` 平均分配当前指定单元格区域内所有列的列宽。
`void` | `averageRowHeight()` 平均分配当前指定单元格区域内所有行的行高。
`void` | `delete(int shiftCells)` 删除当前指定的单元格区域。
`BorderAttribute` | `getBorderAttribute()` 得到指定单元格区域的边框属性。
`Cell` | `getCell(int index)` 得到当前单元格集合中某个指定的单元格对象。
`CellAttribute` | `getCellAttribute()` 得到指定单元格区域的单元格属性。
`int` | `getCount()` 得到当前单元格集合中单元格的数目。
`Rows` | `getRows()` 获得当前单元格区域所在的行集合。
`ShadingAttribute` | `getShadingAttribute()` 得到指定单元格区域的底纹属性。
`Cell` | `merge()` 将指定的单元格区域合并成一个单元格对象。
`void` | `setBorderAttribute(BorderAttribute borderAttribute)` 设置指定单元格区域的边框属性。
`void` | `setCellAttribute(CellAttribute cellAttribute)` 设置指定单元格区域的单元格属性。
`void` | `setShadingAttribute(ShadingAttribute shadingAttribute)` 设置指定单元格区域的底纹属性。
`void` | `split(int row, int column, boolean isMerge)` 拆分表格单元格范围。

从类 java.lang.Object 继承的方法
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

方法详细信息

### addCell

    public Cell addCell(Cell beforeCell,
                        int shiftCells)

  在指定的单元格插入新的单元格。插入新单元格后可选择控制如何移动活动的单元格。

  参数：
    `beforeCell` - 指定单元格
    `shiftCells` - 新单元格插入后，其他活动单元格的补齐方式，只能取以下整型值之一：

         TableConstants.CELL_RIGHTMOVE  活动单元格右移
         TableConstants.CELL_ADOWN      活动单元格下移
         TableConstants.CELL_INSERTROW  整行插入
         TableConstants.CELL_INSERTCOL  整列插入

  返回：
    新插入的单元格

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         application.workbooks.workbook.tables.Cell beforeCell = table.getCell(2,3);
         application.workbooks.workbook.tables.Cell cell = cells.addCell(beforeCell, TableConstants.CELL_INSERTROW);
         cell.getRange().insertText("永中OFFICE");

  抛出：
    `MacroRunException` - 指定单元格补齐方式常量不存在
    `MacroRunException` - 指定单元格对象为空
  另请参见：
    `addCells(int)`

### addCells

    public Cells addCells(int shiftCells)

  根据当前指定的单元格区域插入新的单元格。插入新单元格后可选择控制如何移动活动的单元格。

  参数：
    `shiftCells` - 新单元格插入后，其他活动单元格的补齐方式，只能取以下整型值之一：

         TableConstants.CELL_RIGHTMOVE  活动单元格右移
         TableConstants.CELL_ADOWN      活动单元格下移
         TableConstants.CELL_INSERTROW  整行插入
         TableConstants.CELL_INSERTCOL  整列插入

  返回：
    新插入的单元格集合

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         cells.addCells(TableConstants.CELL_INSERTROW);

  抛出：
    `MacroRunException` - 指定单元格补齐方式常量不存在
  另请参见：
    `addCell(Cell, int)`

### averageColumnWidth

    public void averageColumnWidth()

  平均分配当前指定单元格区域内所有列的列宽。 说明：平均分配后，区域内每个表格列的列宽相等并等于其平均值。

  例子：

       Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
       TextRange range = doc.getRange(0);
       Tables tables = doc.getTables();
       Table table = tables.addTable(range, 5, 5);
       application.workbooks.workbook.tables.Rows rows = table.getRows();
       Row row = rows.getRow(2);
       Cells cells = row.getCells();
       cells.averageColumnWidth();

  另请参见：
    `averageRowHeight()`

### averageRowHeight

    public void averageRowHeight()

  平均分配当前指定单元格区域内所有行的行高。 说明：平均分配后，区域内每个表格行的行高相等并等于其平均值。

  例子：

       Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
       TextRange range = doc.getRange(0);
       Tables tables = doc.getTables();
       Table table = tables.addTable(range, 5, 5);
       application.workbooks.workbook.tables.Rows rows = table.getRows();
       Row row = rows.getRow(2);
       Cells cells = row.getCells();
       cells.averageRowHeight();

  另请参见：
    `averageColumnWidth()`

### delete

    public void delete(int shiftCells)

  删除当前指定的单元格区域。单元格被删除后可选择控制如何移动剩余的单元格。

  参数：
    `shiftCells` - 单元格被删除后，其他活动单元格的补齐方式，只能取以下整型值之一：

         TableConstants.CELL_LEFTMOVE  右侧单元格左移
         TableConstants.CELL_UPMOVE    下方单元格上移
         TableConstants.CELL_DELROW    整行删除
         TableConstants.CELL_DELCOL    整列删除

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         cells.delete(TableConstants.CELL_DELROW);

  抛出：
    `MacroRunException` - 指定参数常量不存在

### getBorderAttribute

    public BorderAttribute getBorderAttribute()

  得到指定单元格区域的边框属性。

  返回：
    边框属性

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         Cells cells = table.getSelectionCells();
         BorderAttribute borderAttribute = cells.getBorderAttribute();
         System.out.println("返回单元格区域的边框类型为:"+ borderAttribute.getBorderType());

  另请参见：
    `setBorderAttribute(BorderAttribute)`

### getCell

    public Cell getCell(int index)

  得到当前单元格集合中某个指定的单元格对象。

  参数：
    `index` - 单元格集合中指定单元格的索引。说明：这个索引值在单元格范围中是按行进行查找的。
  返回：
    单个单元格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         application.workbooks.workbook.tables.Cell cell = cells.getCell(2);
         cell.getRange().insertText("永中科技");

### getCellAttribute

    public CellAttribute getCellAttribute()

  得到指定单元格区域的单元格属性。

  返回：
    单元格属性

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         CellAttribute cellAttribute = cells.getCellAttribute();
         System.out.println("指定单元格宽度的度量方式为：" + cellAttribute.getPreferredWidthMeasure());
         System.out.println("指定单元格的宽度为：" + cellAttribute.getPreferredWidth());

  另请参见：
    `setCellAttribute(CellAttribute)`

### getCount

    public int getCount()

  得到当前单元格集合中单元格的数目。

  返回：
    单元格集合的格子总数

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Columns columns = table.getColumns();
         Column column = columns.getColumn(2);
         Cells cells = column.getCells();
         System.out.println("当前集合中单元格的总数：" + cells.getCount());

### getRows

    public Rows getRows()

  获得当前单元格区域所在的行集合。

  返回：
    单元格区域的行集合对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         Cells cells = table.getSelectingCells();
         application.workbooks.workbook.tables.Rows rows = cells.getRows();
         System.out.println("当前选中的单元格区域的行数为" + rows.getCount());

### getShadingAttribute

    public ShadingAttribute getShadingAttribute()

  得到指定单元格区域的底纹属性。

  返回：
    单元格的底纹属性

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         Cells cells = table.getSelectionCells();
         ShadingAttribute shadingAttribute = cells.getShadingAttribute();
         System.out.println("返回单元格区域的底纹图案索引:"+ shadingAttribute.getTextureIndex());

  另请参见：
    `setShadingAttribute(ShadingAttribute)`

### merge

    public Cell merge()

  将指定的单元格区域合并成一个单元格对象。

  返回：
    合并后的单元格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         application.workbooks.workbook.tables.Cell mergeCell = cells.merge();
         mergeCell.getRange().insertText("永中OFFICE");

  抛出：
    `MacroRunException` - 当前单元格集合不是一个规则区域，不能进行合并单元格操作
  另请参见：
    `split(int, int, boolean)`

### setBorderAttribute

    public void setBorderAttribute(BorderAttribute borderAttribute)

  设置指定单元格区域的边框属性。

  参数：
    `borderAttribute` - 单元格的边框属性

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         Cells cells = table.getSelectionCells();
         BorderAttribute borderAttribute = cells.getBorderAttribute();
         borderAttribute.setBorderType(BorderAndShadingConstants.BORDERTYPE_BOX);
         borderAttribute.setBorderLineType(BorderAndShadingConstants.TOP,1);
         borderAttribute.setBorderLineType(BorderAndShadingConstants.LEFT,3);
         borderAttribute.setBorderLineType(BorderAndShadingConstants.RIGHT,6);
         borderAttribute.setBorderLineType(BorderAndShadingConstants.BOTTOM,8);
         borderAttribute.setBorderLineColor(BorderAndShadingConstants.TOP,Color.RED);
         borderAttribute.setBorderLineColor(BorderAndShadingConstants.LEFT,Color.CYAN);
         borderAttribute.setBorderLineColor(BorderAndShadingConstants.RIGHT,Color.YELLOW);
         borderAttribute.setBorderLineColor(BorderAndShadingConstants.BOTTOM,Color.ORANGE);
         borderAttribute.setBorderLineWidth(BorderAndShadingConstants.TOP,8f);
         borderAttribute.setBorderLineWidth(BorderAndShadingConstants.LEFT,5f);
         borderAttribute.setBorderLineWidth(BorderAndShadingConstants.RIGHT,3f);
         borderAttribute.setBorderLineWidth(BorderAndShadingConstants.BOTTOM,1f);
         cells.setBorderAttribute(borderAttribute);

  抛出：
    `MacroRunException` - 当参数为NULL
  另请参见：
    `getBorderAttribute()`

### setCellAttribute

    public void setCellAttribute(CellAttribute cellAttribute)

  设置指定单元格区域的单元格属性。

  参数：
    `cellAttribute` - 单元格属性

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         CellAttribute cellAttribute = cells.getCellAttribute();
         cellAttribute.setPreferredWidthMeasure(TableConstants.CELL_WIDTH_MEASURE);
         cellAttribute.setPreferredWidth(40.0f);
         cells.setCellAttribute(cellAttribute);

  抛出：
    `MacroRunException` - 当参数为空
  另请参见：
    `getCellAttribute()`

### setShadingAttribute

    public void setShadingAttribute(ShadingAttribute shadingAttribute)

  设置指定单元格区域的底纹属性。

  参数：
    `shadingAttribute` - 单元格的底纹属性

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         Cells cells = table.getSelectionCells();
         ShadingAttribute shadingAttribute = cells.getShadingAttribute();
         shadingAttribute.setTextureIndex(10);
         cells.setShadingAttribute(shadingAttribute);

  抛出：
    `MacroRunException` - 当参数为NULL
  另请参见：
    `getShadingAttribute()`

### split

    public void split(int row,
                      int column,
                      boolean isMerge)

  拆分表格单元格范围。如果对多个连续单元格组成的区域进行拆分时，可以先合并此范围再拆分，或对每个单元格进行相同的拆分。

  参数：
    `row` - 拆分的行数
    `column` - 拆分的列数
    `isMerge` - 是否要先合并单元格再进行拆分

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         application.workbooks.workbook.tables.Rows rows = table.getRows();
         Row row = rows.getRow(2);
         Cells cells = row.getCells();
         cells.split(2, 2, true);

  抛出：
    `MacroRunException` - 当前单元格集合不是一个规则区域，不能进行合并单元格操作
  另请参见：
    `merge()`

概述 | 软件包 | 类 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

版权所有 2001-2008 无锡永中科技有限公司