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

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

## application.workbooks.workbook.worksheets.worksheet
类 Columns

    java.lang.Object
      application.workbooks.workbook.worksheets.worksheet.Columns

    public class Columns

extends java.lang.Object

该类定义了对整列进行操作的一些方法，如插入一列，设置列宽，隐藏列，设置列属性等。

自从：
  V1.1

方法摘要
`void` | `applyStandardColumnWidth()` 应用标准列宽。
`void` | `autoFit()` 设置最佳列宽。
`Columns[]` | `getAllColumns()` 如果选定区域包含多个子区域，返回所有的选定区域。
`int` | `getCount()` 返回选定列的数目。
`int` | `getEndColumn()` 获取结束列列号。
`Range` | `getRange()` 取得对应的Range对象。
`int` | `getStartColumn()` 获取起始列列号。
`Worksheet` | `getWorksheet()` 返回所属的Worksheet对象。
`boolean` | `hasMultiColumns()` 返回选定区域是否包含多个子区域。
`boolean` | `isColumnHidden()` 判断列是否被隐藏。
`void` | `select()` 选中指定列。
`void` | `setBorderAttribute(BorderAttribute ba)` 设置边框属性。
`void` | `setColumnHidden(boolean hide)` 隐藏列。
`void` | `setColumnWidth(double width)` 为当前列设置列宽(默认度量单位:磅)。
`void` | `setFillAttribute(FillAttribute fa)` 设置填充属性。
`void` | `setFontAttribute(FontAttribute ca)` 设置字体属性。
`void` | `setFormatCellAttribute(FormatCellAttribute attr)` 设置单元格格式。

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

方法详细信息

### applyStandardColumnWidth

    public void applyStandardColumnWidth()

  应用标准列宽。

  例子：

       //对第三列至第五列应用标准列宽。
       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Columns columns = worksheet.getColumns("c:e");
       columns.applyStandardColumnWidth();

### autoFit

    public void autoFit()

  设置最佳列宽。

  例子：

       //对第三列至第五列设置最佳列宽。
       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Columns columns = worksheet.getColumns(3,5);
       columns.autoFit();

### getAllColumns

    public Columns[] getAllColumns()

  如果选定区域包含多个子区域，返回所有的选定区域。

  返回：
    所有的选定区域

    例子：

         //本示例将在当前活动的工作表中选择“a列至b列，j列至k列”，输出当前选定区域中每个子区域的起始列和终止列。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns column = sheet.getColumns("a:b,j:k");
         column.select();
         Columns[] columns = column.getAllColumns();

### getCount

    public int getCount()

  返回选定列的数目。

  当应用于含多个选定区域的 Columns 对象时，该属性只返回该区域中第一个子区域内列的数目。

  例如，如果 Columns 对象有两个子区域：A1:B2 和 C3:D4，则 getCount 返回 2 而不是 4。

  若要在一个可能包含多个选定区域的区域中使用该属性，请使用 hasMultiColumns 来判断该区域是否包含多个子区域。

  返回：
    选定列的数目

    例子：

         //返回第三列至第五列的数目。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         int count = columns.getCount();
         System.out.println(count);

### getEndColumn

    public int getEndColumn()

  获取结束列列号。

  返回：
    结束列列号，为整型数值

    例子：

         //获取第三列至第五列的结束列的列号。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         int end = columns.getEndColumn();
         System.out.println(end);

### getRange

    public Range getRange()

  取得对应的Range对象。

  返回：
    Range对象

    例子：

         //取得第三列至第五列所对应的Range对象。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         Range range = columns.getRange();

### getStartColumn

    public int getStartColumn()

  获取起始列列号。

  返回：
    起始列号，为整型数值

    例子：

         //获取第三列至第五列的起始列的列号。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         int start = columns.getStartColumn();
         System.out.println(start);

### getWorksheet

    public Worksheet getWorksheet()

  返回所属的Worksheet对象。

  返回：
    Worksheet对象

    例子：

         //返回第一列至第三列所属的Worksheet对象。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns("a:c");
         columns.getWorksheet();

### hasMultiColumns

    public boolean hasMultiColumns()

  返回选定区域是否包含多个子区域。

  返回：
    是否含有多个选定区域

    例子：

         //本示例将在当前活动的工作表中选择“a列至b列，f列至k列”，输出当前选定区域是否包含多个子区域
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns("a:b,f:k");
         System.out.println(columns.hasMultiColumns());

### isColumnHidden

    public boolean isColumnHidden()

  判断列是否被隐藏。

  返回：
    布尔型值，如果当前列被隐藏，返回true；否则返回false

    例子：

         //判断第三列至第五列是否被隐藏。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         boolean hidden = columns.isColumnHidden();
         System.out.println(hidden);

### select

    public void select()

  选中指定列。

  例子：

       //选中第一列至第三列。
       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Columns columns = worksheet.getColumns("a:c");
       columns.select();

### setBorderAttribute

    public void setBorderAttribute(BorderAttribute ba)

  设置边框属性。

  参数：
    `ba` - 边框属性

    例子：

         //设置第三列至第五列单元格的边框属性。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         BorderAttribute border = new BorderAttribute();
         border.setApplyType(BorderAndShadingConstants.APPLY_CELL);
         border.setBorderType(BorderAndShadingConstants.BORDERTYPE_CUSTOM);
         border.setBorderLineType(BorderAndShadingConstants.LEFT,0);
         border.setBorderLineWidth(BorderAndShadingConstants.LEFT,0.5f);
         border.setBorderLineType(BorderAndShadingConstants.RIGHT,0);
         border.setBorderLineWidth(BorderAndShadingConstants.RIGHT,0.5f);
         border.setBorderLineType(BorderAndShadingConstants.MIDDLE_VERTICAL,0);
         border.setBorderLineWidth(BorderAndShadingConstants.MIDDLE_VERTICAL,0.5f);
         columns.setBorderAttribute(border);

### setColumnHidden

    public void setColumnHidden(boolean hide)

  隐藏列。

  参数：
    `hide` - 布尔型值，如为true，隐藏当前列；否则不隐藏当前列

    例子：

         //隐第三列至第五列。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         columns.setColumnHidden(true);

### setColumnWidth

    public void setColumnWidth(double width)

  为当前列设置列宽(默认度量单位:磅)。

  参数：
    `width` - 设置的列宽，为double型,单位:磅,其取值范围在0至1530.0 磅

    例子：

         //设置第三列至第五列的列宽为20毫米。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         double ptValue = Utilities.otherToPoint(20.0,UnitConstants.MILLIMETER);
         columns.setColumnWidth(ptValue);

  抛出：
    `MacroRunException` - 当给定参数的数值错误或越界

### setFillAttribute

    public void setFillAttribute(FillAttribute fa)

  设置填充属性。

  参数：
    `fa` - 填充属性

    例子：

         //设置第三列至第五列的填充属性。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         FillAttribute fill = new FillAttribute();
         fill.setTexture(255,204,153);
         columns.setFillAttribute(fill);

### setFontAttribute

    public void setFontAttribute(FontAttribute ca)

  设置字体属性。

  参数：
    `ca` - 字体属性

    例子：

         //设置第三列至第五列单元格的字体属性。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         FontAttribute font = new FontAttribute();
         font.setBold(true);
         font.setForeground(255,0,0);
         font.setStrikeThrough(true);
         columns.setFontAttribute(font);

### setFormatCellAttribute

    public void setFormatCellAttribute(FormatCellAttribute attr)

  设置单元格格式。

  参数：
    `attr` - 单元格格式

    例子：

         //设置第三列至第五列单元格的格式。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(3,5);
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_MIDDLE);
         columns.setFormatCellAttribute(fcAttribute);

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

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

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