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

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

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

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

    public class ConditionalFormattingData

extends java.lang.Object

该类定义了条件格式，提供了条件格式化的操作方法。

自从：
  V1.31

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

方法摘要
`void` | `setBackground(java.awt.Color color)` 设置条件格式化的背景色。
`void` | `setBorderAttribute(BorderAttribute border)` 设置条件格式化的边框。
`void` | `setFontAttribute(FontAttribute font)` 设置条件格式化的字体。
`void` | `setFormula1(java.lang.String value)` 设置与条件格式相关的表达式或数值，可为常量、字符串、单元格引用或公式。
`void` | `setFormula2(java.lang.String value)` 当运算符为“介于”或“未介于”时，设置与条件格式第二部分相关的表达式或数值（否则，则忽略本参数）。
`void` | `setHowIndex(int index)` 设置条件运算符类型。
`void` | `setWhatIndex(int type)` 指定条件格式是基于单元格值还是基于表达式。

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

构造函数详细信息

### ConditionalFormattingData

    public ConditionalFormattingData()

  默认构件器。

方法详细信息

### setBackground

    public void setBackground(java.awt.Color color)

  设置条件格式化的背景色。

  参数：
    `color` - 条件格式化的背景色

    例子：

         //在单元格区域"C7:F14"中，将单元格数值介于0.3至0.6的单元格的背景色设置为Color(153,204,255)。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         formattingData.setBackground(new Color(153,204,255));
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

### setBorderAttribute

    public void setBorderAttribute(BorderAttribute border)

  设置条件格式化的边框。

  参数：
    `border` - 条件格式化的边框

    例子：

         //在单元格区域"C7:F14"中，将单元格数值介于0.3至0.6的单元格上，下，左，右边框的宽度设置为0.5。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         BorderAttribute border = new BorderAttribute();
         border.setApplyType(BorderAndShadingConstants.APPLY_CELL);
         border.setBorderType(BorderAndShadingConstants.BORDERTYPE_NONE);
         border.setBorderLineType(BorderAndShadingConstants.LEFT,0);
         border.setBorderLineWidth(BorderAndShadingConstants.LEFT,0.5f);
         border.setBorderLineType(BorderAndShadingConstants.TOP,0);
         border.setBorderLineWidth(BorderAndShadingConstants.TOP,0.5f);
         border.setBorderLineType(BorderAndShadingConstants.RIGHT,0);
         border.setBorderLineWidth(BorderAndShadingConstants.RIGHT,0.5f);
         border.setBorderLineType(BorderAndShadingConstants.BOTTOM,0);
         border.setBorderLineWidth(BorderAndShadingConstants.BOTTOM,0.5f);
         formattingData.setBorderAttribute(border);
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

### setFontAttribute

    public void setFontAttribute(FontAttribute font)

  设置条件格式化的字体。

  参数：
    `font` - 条件格式化的字体

    例子：

         //将符合条件格式区域的字体前景色设置为红色。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         FontAttribute font = new FontAttribute();
         font.setForeground(Color.red);
         formattingData.setFontAttribute(font);
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

### setFormula1

    public void setFormula1(java.lang.String value)

  设置与条件格式相关的表达式或数值，可为常量、字符串、单元格引用或公式。

  参数：
    `value` - 与条件格式相关的表达式或数值

    例子：

         //在"C7:F14"单元格区域中，将单元格值介于0.3至0.6的单元格内容的前景色设为红色。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         FontAttribute font = new FontAttribute();
         font.setForeground(Color.red);
         formattingData.setFontAttribute(font);
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

### setFormula2

    public void setFormula2(java.lang.String value)

  当运算符为“介于”或“未介于”时，设置与条件格式第二部分相关的表达式或数值（否则，则忽略本参数）。可为常量、字符串、单元格引用或公式。

  参数：
    `value` - 与条件格式相关的表达式或数值

    例子：

         //设置条件格式为介于0.3至0.6。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         FontAttribute font = new FontAttribute();
         font.setForeground(Color.red);
         formattingData.setFontAttribute(font);
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

### setHowIndex

    public void setHowIndex(int index)

  设置条件运算符类型。

  参数：
    `index` - 条件运算符类型,如果条件格式是基于表达式，则设置无效，其取值为如下常量:

             BETWEEN -- 介于
             NOT_BETWEEN -- 不介于
             EQUALS -- 等于
             NOT_EQUALS -- 不等于
             GREATER_THAN -- 大于
             LESS_THAN -- 小于
             GREATER_THAN_OR_EQUALS -- 大于等于
             LESS_THAN_OR_EQUALS -- 小于等于

    例子：

         //设置条件运算符类型为介于。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         FontAttribute font = new FontAttribute();
         font.setForeground(Color.red);
         formattingData.setFontAttribute(font);
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

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

### setWhatIndex

    public void setWhatIndex(int type)

  指定条件格式是基于单元格值还是基于表达式。

  参数：
    `type` - 类型，其取值为如下常量:

             VALUE_IS  基于单元格值
             FORMULA_IS  基于表达式

         例子：

         //设置基于单元格的条件格式。
         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("C7:F14");
         range.fillRandom();
         ConditionalFormatting conditionalFormatting = new ConditionalFormatting();
         ConditionalFormattingData  formattingData = new ConditionalFormattingData();
         formattingData.setWhatIndex(ConditionConstants.VALUE_IS);
         formattingData.setHowIndex(ConditionConstants.BETWEEN);
         formattingData.setFormula1("0.3");
         formattingData.setFormula2("0.6");
         FontAttribute font = new FontAttribute();
         font.setForeground(Color.red);
         formattingData.setFontAttribute(font);
         conditionalFormatting.add(formattingData);
         range.setConditionalFormatting(conditionalFormatting);

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

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

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

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