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

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

## application.workbooks.workbook.worksheets
类 FormatCellAttribute

    java.lang.Object
      application.workbooks.workbook.worksheets.FormatCellAttribute

    public class FormatCellAttribute

extends java.lang.Object

单元格格式化属性。

自从：
  1.31

构造函数摘要
`FormatCellAttribute()` 默认构件器。

方法摘要
`int` | `getAddIndent()` 判断单元格区域是否两端分散对齐。
`int` | `getCategory()` 取得数值的格式。
`int` | `getDegree()` 得到单元格中文本的旋转角度。
`java.lang.String` | `getFormat()` 取得对应于数字格式类别的某一字串。
`int` | `getHorizontalIndex()` 获取单元格内容水平对齐方式索引值。
`int` | `getIndentSpinValue()` 获取单元格内容缩进值。
`int` | `getMerge()` 判断单元格区域是否设置了合并单元格。
`int` | `getOrientationType()` 判断单元格区域内文本排列的方向。
`int` | `getShrinkFit()` 判断单元格区域是否设置了缩小字体填充。
`int` | `getVerticalIndex()` 获取单元格内容垂直对齐方式索引值。
`int` | `getWrap()` 判断单元格区域内容是否自动换行。
`void` | `setAddIndent(boolean addIndent)` 设置两端分散对齐(只有在单元格水平对齐方式为分散对齐时才有效)。
`void` | `setCategory(int category)` 设定数字的格式。
`void` | `setDegree(int degree)` 设置单元格中文本的旋转角度。
`void` | `setFormat(java.lang.String format)` 根据对应于数字格式类别的某一字串设置数字格式。
`void` | `setHorizontalIndex(int horizontalIndex)` 设置水平对齐。
`void` | `setIndentSpinValue(int indentSpinValue)` 设置单元格内容缩进。
`void` | `setMerge(boolean merge)` 设置合并单元格。
`void` | `setOrientation(boolean orientation)` 设置单元格内文本的方向,(若已设置文本的旋转角度,则单元格内文本的方向为不是竖排文本)。
`void` | `setShrinkFit(boolean shrinkFit)` 设置缩小字体填充选项。
`void` | `setVerticalIndex(int verticalIndex)` 设置垂直对齐。
`void` | `setWrap(boolean wrap)` 设置自动换行

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

构造函数详细信息

### FormatCellAttribute

    public FormatCellAttribute()

  默认构件器。

方法详细信息

### getAddIndent

    public int getAddIndent()

  判断单元格区域是否两端分散对齐。

  返回：
    整型值 ，其取值为如下：

          9999999表示三态，
          0表示不设置两端分散对齐，相当于isAddIndent() API返回false，
          1表示设置了两端分散对齐，相当于isAddIndent() API返回true，

    例子:

         //得到单元格区域是否两端分散对齐,1表示设置了两端分散对齐
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_BOTH_SCATTER);
         fcAttribute.setAddIndent(true);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int value = fcAttribute1.getAddIndent();

### getCategory

    public int getCategory()

  取得数值的格式。

  返回：
    数值格式

    例子:

         //得到数值的格式
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setCategory(2);
         fcAttribute.setFormat("￥#,##0.00;￥-#,##0.00");
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int type = fcAttribute1.getCategory();

### getDegree

    public int getDegree()

  得到单元格中文本的旋转角度。

  返回：
    旋转角度

    例子:

          //得到单元格中文本的旋转角度
          Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
          Range range = worksheet.getActiveRange();
          FormatCellAttribute fcAttribute = new FormatCellAttribute();
          fcAttribute.setDegree(40);
          range.setFormatCellAttribute(fcAttribute);
          FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
          int value = fcAttribute1.getDegree();

### getFormat

    public java.lang.String getFormat()

  取得对应于数字格式类别的某一字串。

  返回：
    对应于数字格式类别的某一字串

    例子:

         //得到对应于数字格式类别的字串
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setCategory(2);
         fcAttribute.setFormat("￥#,##0.00;￥-#,##0.00");
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         String str = fcAttribute1.getFormat();

### getHorizontalIndex

    public int getHorizontalIndex()

  获取单元格内容水平对齐方式索引值。

  返回：
    水平对齐的方式索引值

    例子:

         //获取单元格内容水平对齐方式索引值
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_MIDDLE);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 =range.getFormatCellAttribute();
         int index = fcAttribute1.getHorizontalIndex();

### getIndentSpinValue

    public int getIndentSpinValue()

  获取单元格内容缩进值。

  返回：
    单元格内容缩进值

    例子:

         //获取单元格内容缩进值
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_LEFT);
         fcAttribute.setIndentSpinValue(5);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int value = fcAttribute1.getIndentSpinValue();

### getMerge

    public int getMerge()

  判断单元格区域是否设置了合并单元格。

  返回：
    整型值 ，其取值为如下：

          9999999表示三态，
          0表示不设置合并单元格，相当于isMerge() API返回false，
          1表示设置了合并单元格，相当于isMerge() API返回true，

    例子:

         //得到单元格区域是否设置了合并单元格,1 表示设置了合并单元格
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setMerge(true);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int value = fcAttribute1.getMerge();

### getOrientationType

    public int getOrientationType()

  判断单元格区域内文本排列的方向。

  返回：
    整型值 ，其取值为如下：

          9999999表示三态，
          0表示设置横排，相当于getOrientation() API返回false，
          1表示设置竖排，相当于getOrientation() API返回true，

    例子:

          //得到单元格区域内文本排列的方向,1 表示设置竖排
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setOrientation(true);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int value = fcAttribute1.getOrientationType();

### getShrinkFit

    public int getShrinkFit()

  判断单元格区域是否设置了缩小字体填充。

  返回：
    整型值 ，其取值为如下：

          9999999表示三态，
          0表示不设置了缩小字体填充，相当于isShrinkFit() API返回false，
          1表示设置了缩小字体填充，相当于isShrinkFit() API返回true，

    例子:

         //单元格区域是否设置了缩小字体填充, 1 表示设置了缩小字体填充
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setShrinkFit(true);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int value = fcAttribute1.getShrinkFit();

### getVerticalIndex

    public int getVerticalIndex()

  获取单元格内容垂直对齐方式索引值。

  返回：
    垂直对齐的方式索引值

    例子:

         //获取单元格内容垂直对齐方式索引值
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setVerticalIndex(CellFormatConstants.VER_MIDDLE);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int index = fcAttribute1.getVerticalIndex();

### getWrap

    public int getWrap()

  判断单元格区域内容是否自动换行。

  返回：
    整型值 ，其取值为如下：

          9999999表示三态，
          0表示不自动换行，相当于isWrap() API返回false，
          1表示自动换行，相当于isWrap() API返回true，

    例子:

         //得到单元格区域内容是否自动换行, 1 表示自动换行
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setWrap(true);
         range.setFormatCellAttribute(fcAttribute);
         FormatCellAttribute fcAttribute1 = range.getFormatCellAttribute();
         int value = fcAttribute1.getWrap();

### setAddIndent

    public void setAddIndent(boolean addIndent)

  设置两端分散对齐(只有在单元格水平对齐方式为分散对齐时才有效)。

  参数：
    `addIndent` - TRUE表示设置两端分散对齐，FALSE表示不设置两端分散对齐

    例子:

         //设置单元格两端分散对齐
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_BOTH_SCATTER);
         fcAttribute.setAddIndent(true);
         range.setFormatCellAttribute(fcAttribute);

### setCategory

    public void setCategory(int category)

  设定数字的格式。

  参数：
    `category` - 数值格式，其常量和相应的值如下：

         CellFormatConstants.NUMBER_GENERAL = 0（一般格式）
         CellFormatConstants.NUMBER_NUMBER = 1（数值格式）
         CellFormatConstants.NUMBER_CURRENCY = 2（货币格式）
         CellFormatConstants.NUMBER_ACCOUNTING = 3（会计专用格式）
         CellFormatConstants.DATE = 4（日期格式）
         CellFormatConstants.TIME = 5（时间格式）
         CellFormatConstants.NUMBER_PERCENTAGE = 6（百分比格式）
         CellFormatConstants.NUMBER_FRACTION = 7（分数格式）
         CellFormatConstants.NUMBER_SCIENTIFIC = 8（科学记数格式）
         CellFormatConstants.NUMBER_TEXT = 9（文本格式）
         CellFormatConstants.NUMBER_SPECIAL = 10（特殊格式）
         CellFormatConstants.NUMBER_CUSTOM = 11（用户自定义）

    例子:

         //设置当前单元格区域的数字格式为货币格式
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setCategory(2);
         fcAttribute.setFormat("￥#,##0.00;￥-#,##0.00");
         range.setFormatCellAttribute(fcAttribute);

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

### setDegree

    public void setDegree(int degree)

  设置单元格中文本的旋转角度。

  参数：
    `degree` - 旋转角度，取值范围为－90到90
  抛出：
    `MacroRunException` - 当给定参数的数值错误或越界

    例子:

         //设置单元格中文本的旋转角度为40
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setDegree(40);
         range.setFormatCellAttribute(fcAttribute);

### setFormat

    public void setFormat(java.lang.String format)

  根据对应于数字格式类别的某一字串设置数字格式。

  参数：
    `format` - 对应于数字格式类别的某一字串

    例子:

         //设置当前工作表中被激活的单元格区域为货币格式，格式类别为￥#,##0.00
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setCategory(2);
         fcAttribute.setFormat("￥#,##0.00;￥-#,##0.00");
         range.setFormatCellAttribute(fcAttribute);

### setHorizontalIndex

    public void setHorizontalIndex(int horizontalIndex)

  设置水平对齐。

  参数：
    `horizontalIndex` - 水平对齐的索引值，其取值为如下常量：

         HOR_NORMAL   -- 表示常规格式
         HOR_LEFT -- 表示左对齐
         HOR_MIDDLE   --  表示居中
         HOR_RIGHT    --  表示右对齐
         HOR_FILL -- 表示填充
         HOR_BOTH -- 表示两端对齐
         HOR_ACROSS_MIDDLE    -- 表示跨列居中
         HOR_BOTH_SCATTER -- 表示两端分散对齐

    例子:

         //设置单元格水平对齐的方式为居中
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_MIDDLE);
         range.setFormatCellAttribute(fcAttribute);

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

### setIndentSpinValue

    public void setIndentSpinValue(int indentSpinValue)

  设置单元格内容缩进。

  参数：
    `indentSpinValue` - 缩进值，取值范围为0到15

    注：只有水平对齐选择左对齐(缩进)时,此设置才有效。

    例子:

         //设置单元格内容缩进,缩进值为5
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setHorizontalIndex(CellFormatConstants.HOR_LEFT);
         fcAttribute.setIndentSpinValue(5);
         range.setFormatCellAttribute(fcAttribute);

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

### setMerge

    public void setMerge(boolean merge)

  设置合并单元格。

  参数：
    `merge` - 布尔型值，如为true，则合并单元格；否则，不合并单元格

    例子:

         //设置合并单元格
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setMerge(true);
         range.setFormatCellAttribute(fcAttribute);

### setOrientation

    public void setOrientation(boolean orientation)

  设置单元格内文本的方向,(若已设置文本的旋转角度,则单元格内文本的方向为不是竖排文本)。

  参数：
    `orientation` - 表示如何设置单元格内文本的方向，为布尔型值 如为true，则竖排文本；否则，则设置文本的旋转角度

    例子:

         //设置当前工作表中被激活的单元格区域为竖排文本
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setOrientation(true);
         range.setFormatCellAttribute(fcAttribute);

### setShrinkFit

    public void setShrinkFit(boolean shrinkFit)

  设置缩小字体填充选项。

  参数：
    `shrinkFit` - 布尔型值，如为true，则缩小字体填充；否则，不设置缩小字体填充

    例子:

         //设置单元格区域缩小字体填充
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setShrinkFit(true);
         range.setFormatCellAttribute(fcAttribute);

### setVerticalIndex

    public void setVerticalIndex(int verticalIndex)

  设置垂直对齐。

  参数：
    `verticalIndex` - 垂直对齐的索引值，其取值为如下常量：

         VER_TOP -- 表示靠上
         VER_MIDDLE -- 表示居中
         VER_BOTTOM -- 表示靠下
         VER_BOTH -- 表示上下两端对齐

    例子:

         //设置单元格垂直对齐的方式为居中
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setVerticalIndex(CellFormatConstants.VER_MIDDLE);
         range.setFormatCellAttribute(fcAttribute);

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

### setWrap

    public void setWrap(boolean wrap)

  设置自动换行

  参数：
    `wrap` - 布尔型值，如为true，自动换行；否则，取消自动换行 （假如是ture，则缩小字体填充选项将不可用）

    例子:

         //设置单元格区域自动换行
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         FormatCellAttribute fcAttribute = new FormatCellAttribute();
         fcAttribute.setWrap(true);
         range.setFormatCellAttribute(fcAttribute);

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

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

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