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

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

## application.workbooks.workbook.tables
类 Rows

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

    public class Rows

extends java.lang.Object

代表指定范围的表格行的集合，可能包括一个或多个连续的表格行。

方法摘要
`Row` | `addRow(Row beforeRow, int direction)` 在指定行的上方或下方插入一行。
`void` | `averageRowHeight()` 平均分配表格行集合内所有行的行高。
`void` | `delete()` 删除当前指定表格行的集合。
`BorderAttribute` | `getBorderAttribute()` 得到表格行集合外边框的边框属性。
`int` | `getCount()` 得到当前表格行集合中行的数目。
`Row` | `getRow(int index)` 得到指定的表格行。
`ShadingAttribute` | `getShadingAttribute()` 得到表格行集合的底纹属性。
`Row` | `nextRow()` 得到当前表格行集合的下一个行对象。
`Row` | `previousRow()` 得到当前表格行集合的上一个行对象。
`void` | `removeRow(int index)` 删除指定的表格行。
`void` | `select()` 将当前指定的表格行集合选中。
`void` | `setAllowRowSpan(boolean rowSpan)` 设置表格行集合内所有行的跨页换行属性。
`void` | `setBorderAttribute(BorderAttribute borderAttribute)` 设置表格行集合外边框的边框属性。
`void` | `setRowHeight(float rowHeight)` 设置表格行集合内所有行的行高。
`void` | `setRowHeightMeasure(int measureType)` 设置表格行集合内所有行的高度的度量类型。
`void` | `setShadingAttribute(ShadingAttribute shadingAttribute)` 设置表格行集合的底纹属性。
`void` | `setTitleRow(boolean isRepeat)` 设置表格行集合内的所有行是否为标题行。

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

方法详细信息

### addRow

    public Row addRow(Row beforeRow,
                      int direction)

  在指定行的上方或下方插入一行。

  参数：
    `beforeRow` - 指定的行对象
    `direction` - 插入行的方向，只能取以下整型值之一：

         TableConstants.INSERT_ROW_ABOVE   在指定区域的上方插入行
         TableConstants.INSERT_ROW_BELLOW  在指定区域的下方插入行

  返回：
    新插入的表格行对象

    例子：

         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 beforeRow = rows.getRow(3);
         Row row = rows.addRow(beforeRow, TableConstants.INSERT_ROW_ABOVE);
         row.select();

  抛出：
    `MacroRunException` - 当指定行对象为空
    `MacroRunException` - 当插入行的方向不存在

### 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(2, 3);
       rows.averageRowHeight();

### delete

    public void delete()

  删除当前指定表格行的集合。

  例子：

       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(2,3);
       rows.delete();

  另请参见：
    `removeRow(int);`, `Row.delete()`

### 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);
         application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
         BorderAttribute borderAttribute = rows.getBorderAttribute();
         System.out.println("返回表格行集合外边框的类型为:"+ borderAttribute.getBorderType());

  另请参见：
    `setBorderAttribute(BorderAttribute)`

### 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.Rows rows = table.getRows();
         System.out.println("表格共有" + rows.getCount() + "行");

### getRow

    public Row getRow(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);
         row.select();

  抛出：
    `MacroRunException` - 当指定的行中包含有纵向合并单元格

### 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);
         application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
         ShadingAttribute shadingAttribute = rows.getShadingAttribute();
         System.out.println("返回行集合的底纹图案索引:"+ shadingAttribute.getTextureIndex());

  另请参见：
    `setShadingAttribute(ShadingAttribute)`

### nextRow

    public Row nextRow()

  得到当前表格行集合的下一个行对象。

  返回：
    下一行对象

    例子：

         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(2, 3);
         Row row = rows.nextRow();
         row.select();

  抛出：
    `MacroRunException` - 当返回的下一行对象中含有纵向合并的单元格
  另请参见：
    `previousRow()`

### previousRow

    public Row previousRow()

  得到当前表格行集合的上一个行对象。

  返回：
    上一行对象

    例子：

         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(2, 3);
         Row row = rows.previousRow();
         row.select();

  抛出：
    `MacroRunException` - 当返回的上一行对象中含有纵向合并的单元格
  另请参见：
    `nextRow()`

### removeRow

    public void removeRow(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();
         rows.removeRow(2);

  抛出：
    `当指定表格行的索引超出范围`
  另请参见：
    `delete()`, `Row.delete()`

### select

    public void select()

  将当前指定的表格行集合选中。

  例子：

       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(2, 3);
       rows.select();

### setAllowRowSpan

    public void setAllowRowSpan(boolean rowSpan)

  设置表格行集合内所有行的跨页换行属性。

  参数：
    `rowSpan` - 是否跨页换行。如果该属性值为 True，则表示允许分页符拆分表格中一行或多行中的文本

    例子：

         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(2, 3);
         rows.setAllowRowSpan(true);

### 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);
         application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
         BorderAttribute borderAttribute = rows.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);
         rows.setBorderAttribute(borderAttribute);

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

### setRowHeight

    public void setRowHeight(float rowHeight)

  设置表格行集合内所有行的行高。

  参数：
    `rowHeight` - 指定表格行的行高，默认以磅值为单位，范围在0~1584磅

    例子：

         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(2, 3);
         rows.setRowHeightMeasure(TableConstants.ROW_MINIM_VALUE);
         rows.setRowHeight(40.0f);

  抛出：
    `MacroRunException` - 当行高超出范围
  另请参见：
    `setRowHeightMeasure(int)`

### setRowHeightMeasure

    public void setRowHeightMeasure(int measureType)

  设置表格行集合内所有行的高度的度量类型。

  参数：
    `measureType` - 行高度的度量类型，只能取下面值之一：

         TableConstants.ROW_HEIGHT_NONE_SET  不指定行高度
         TableConstants.ROW_MINIM_VALUE      指定行高度为最小值
         TableConstants.ROW_FIXED_VALUE      指定行高度为固定值

    例子：

         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(2, 3);
         rows.setRowHeightMeasure(TableConstants.ROW_FIXED_VALUE);
         rows.setRowHeight(40.0f);

  抛出：
    `MacroRunException` - 当行高度的度量类型不存在
  另请参见：
    `setRowHeight(float)`

### 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);
         application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
         ShadingAttribute shadingAttribute = rows.getShadingAttribute();
         shadingAttribute.setTextureIndex(10);
         rows.setShadingAttribute(shadingAttribute);

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

### setTitleRow

    public void setTitleRow(boolean isRepeat)

  设置表格行集合内的所有行是否为标题行。

  参数：
    `isRepeat` - 是否为标题行。如果该属性值为 True，则表示指定行可以以标题行形式重复出现在各页顶端

    例子：

         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(2, 3);
         rows.setTitleRow(true);

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

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

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