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

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

## application.workbooks.workbook.tables
类 Columns

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

    public class Columns

extends java.lang.Object

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

方法摘要
`Column` | `addColumn(Column beforeColumn, int direction)` 在指定列的左边或右边插入一列。
`void` | `averageColumnWidth()` 平均分配表格列集合内所有列的列宽。
`void` | `delete()` 删除当前指定表格列的集合。
`BorderAttribute` | `getBorderAttribute()` 得到表格列集合外边框的边框属性。
`Column` | `getColumn(int index)` 得到指定的表格列。
`int` | `getCount()` 得到当前表格列集合中列的数目。
`ShadingAttribute` | `getShadingAttribute()` 得到表格列集合的底纹属性。
`Column` | `nextColumn()` 得到当前表格列集合的右边一个列对象。
`Column` | `previousColumn()` 得到当前表格列集合的左边一个列对象。
`void` | `removeColumn(int index)` 删除指定的表格列。
`void` | `select()` 选中当前指定的连续表格列。
`void` | `setBorderAttribute(BorderAttribute borderAttribute)` 设置表格列集合外边框的边框属性。
`void` | `setColumnWidth(float columnWidth)` 设置表格列集合内所有列的列宽。
`void` | `setColumnWidthMeasure(int measureType)` 设置表格列集合内所有列的宽度的度量类型。
`void` | `setShadingAttribute(ShadingAttribute shadingAttribute)` 设置表格列集合的底纹属性。

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

方法详细信息

### addColumn

    public Column addColumn(Column beforeColumn,
                            int direction)

  在指定列的左边或右边插入一列。

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

         TableConstants.INSERT_COLUMN_LEFT   在指定区域的左边插入列
         TableConstants.INSERT_COLUMN_RIGHT  在指定区域的右边插入列

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

    例子：

         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 beforeColumn = columns.getColumn(2);
         Column column = columns.addColumn(beforeColumn, TableConstants.INSERT_COLUMN_LEFT);
         column.select();

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

### 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.Columns columns = table.getColumns(2, 3);
       columns.averageColumnWidth();

### 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.Columns columns = table.getColumns(2,3);
       columns.delete();

  另请参见：
    `removeColumn(int)`, `Column.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.Columns columns = table.getColumns(2, 3);
         BorderAttribute borderAttribute = columns.getBorderAttribute();
         System.out.println("返回表格列集合外边框的类型为:"+ borderAttribute.getBorderType());

  另请参见：
    `setBorderAttribute(BorderAttribute)`

### getColumn

    public Column getColumn(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.Columns columns = table.getColumns();
         Column column = columns.getColumn(2);
         column.select();

  抛出：
    `MacroRunException` - 当指定的列中含有混合的单元格宽度

### 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();
         System.out.println("表格共有" + columns.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);
         application.workbooks.workbook.tables.Columns columns = table.getColumns(2, 3);
         ShadingAttribute shadingAttribute = columns.getShadingAttribute();
         System.out.println("返回列集合的底纹图案索引:"+ shadingAttribute.getTextureIndex());

  另请参见：
    `setShadingAttribute(ShadingAttribute)`

### nextColumn

    public Column nextColumn()

  得到当前表格列集合的右边一个列对象。

  返回：
    右一列对象

    例子：

         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(2, 3);
         Column column = columns.nextColumn();
         column.select();

  抛出：
    `MacroRunException` - 当返回的右一列对象中含有混合的单元格宽度
  另请参见：
    `previousColumn()`

### previousColumn

    public Column previousColumn()

  得到当前表格列集合的左边一个列对象。

  返回：
    左一列对象

    例子：

         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(2, 3);
         Column column = columns.previousColumn();
         column.select();

  抛出：
    `MacroRunException` - 当返回的左一列对象中含有混合的单元格宽度
  另请参见：
    `nextColumn()`

### removeColumn

    public void removeColumn(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.Columns columns = table.getColumns();
         columns.removeColumn(2);

  抛出：
    `当指定表格行的索引超出范围`
  另请参见：
    `delete()`, `Column.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.Columns columns = table.getColumns(2,3);
       columns.select();

### 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.Columns columns = table.getColumns(2, 3);
         BorderAttribute borderAttribute = columns.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);
         columns.setBorderAttribute(borderAttribute);

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

### setColumnWidth

    public void setColumnWidth(float columnWidth)

  设置表格列集合内所有列的列宽。

  参数：
    `columnWidth` - 指定表格列的列宽 说明：列宽的度量类型不同，列宽值的语义也不一样。如果，度量类型为固定值，则指定列宽值为磅值，范围在0~1584磅； 如果度量类型为百分比，则指定列宽值是一个相对值，范围在0~100%。

    例子：

         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(2, 3);
         columns.setColumnWidthMeasure(TableConstants.COLUMN_WIDTH_MEASURE);
         columns.setColumnWidth(40.0f);

  抛出：
    `MacroRunException` - 当指定列宽值超出范围
  另请参见：
    `setColumnWidthMeasure(int)`

### setColumnWidthMeasure

    public void setColumnWidthMeasure(int measureType)

  设置表格列集合内所有列的宽度的度量类型。

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

         TableConstants.COLUMN_WIDTH_NONE_SET  不指定列宽度
         TableConstants.COLUMN_WIDTH_MEASURE   指定列宽度为绝对值
         TableConstants.COLUMN_WIDTH_PRECENT   指定列宽度为百分比

    例子：

         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(2, 3);
         columns.setColumnWidthMeasure(TableConstants.COLUMN_WIDTH_PRECENT);
         columns.setColumnWidth(40.0f);

  抛出：
    `MacroRunException` - 当指定列宽度量类型常量不存在
  另请参见：
    `setColumnWidth(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.Columns columns = table.getColumns(2, 3);
         ShadingAttribute shadingAttribute = columns.getShadingAttribute();
         shadingAttribute.setTextureIndex(10);
         columns.setShadingAttribute(shadingAttribute);

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

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

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

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