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

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

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

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

    public class ValidationProperties

extends java.lang.Object

该类定义了设置校验的一些方法。

自从：
  V1.1

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

方法摘要
`void` | `setAlertStyle(int alertStyle)` 设置出错警告的样式。
`void` | `setDropDown(boolean dropDown)` 设置是否提供下拉箭头。
`void` | `setErrorMessage(java.lang.String errorMessage)` 设置警告信息的内容。
`void` | `setErrorTitle(java.lang.String errorTitle)` 设置警告对话框的标题。
`void` | `setFirstParameter(java.lang.String firstPara)` 设置比较的第一个值或公式。
`void` | `setIgnoreBlank(boolean ignoreBlank)` 设置是否忽略空单元格。
`void` | `setInputMessage(java.lang.String inputMessage)` 设置提示信息的内容。
`void` | `setInputTitle(java.lang.String inputTitle)` 设置提示信息的标题。
`void` | `setOperator(int operator)` 设置比较操作符。
`void` | `setSecondParameter(java.lang.String secondPara)` 设置比较的第二个值或公式。
`void` | `setShowError(boolean showError)` 设置是否显示警告信息。
`void` | `setShowInput(boolean showInput)` 设置是否显示提示信息。
`void` | `setType(int type)` 设置校验的类型。

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

构造函数详细信息

### ValidationProperties

    public ValidationProperties()

  默认构件器。

方法详细信息

### setAlertStyle

    public void setAlertStyle(int alertStyle)

  设置出错警告的样式。

  参数：
    `alertStyle` - 设置出错警告的样式，alertStyle可取下列值：

         ALERT_STOP － 则样式为终止
         ALERT_WARN － 则样式为警告
         ALERT_INFO － 则样式为信息

    例子：

         //此例设置出错警告的样式为终止。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

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

### setDropDown

    public void setDropDown(boolean dropDown)

  设置是否提供下拉箭头。

  参数：
    `dropDown` - 布尔型，如为true，提供下拉箭头；否则不提供下拉箭头

    例子：

         //此例设置提供下拉箭头。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setIgnoreBlank(true);
         validation.setDropDown(true);
         validation.setShowInput(true);
         validation.setInputTitle("Input");
         validation.setInputMessage("mmmmmmm");
         range.setValidation(validation);

### setErrorMessage

    public void setErrorMessage(java.lang.String errorMessage)

  设置警告信息的内容。

  参数：
    `errorMessage` - 警告对话框的内容

    例子：

         //此例设置警告信息的内容为"EEEEEEE"。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

### setErrorTitle

    public void setErrorTitle(java.lang.String errorTitle)

  设置警告对话框的标题。

  参数：
    `errorTitle` - 警告对话框的标题

    例子：

         //此例设置警告对话框的标题为"ERROR"。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

### setFirstParameter

    public void setFirstParameter(java.lang.String firstPara)

  设置比较的第一个值或公式。

  参数：
    `firstPara` - 比较的第一(或唯一)个值或公式

    例子：

         //此例设置比较的第一个值是0.3。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

### setIgnoreBlank

    public void setIgnoreBlank(boolean ignoreBlank)

  设置是否忽略空单元格。

  参数：
    `ignoreBlank` - 布尔型，如为true，则忽略空单元格；否则不忽略空单元格

    例子：

         //此例设置忽略空单元格。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setIgnoreBlank(true);
         validation.setDropDown(true);
         validation.setShowInput(true);
         validation.setInputTitle("Input");
         validation.setInputMessage("mmmmmmm");
         range.setValidation(validation);

### setInputMessage

    public void setInputMessage(java.lang.String inputMessage)

  设置提示信息的内容。

  参数：
    `inputMessage` - 输入提示信息的内容

    例子：

         //此例设置提示信息的内容为"mmmmmmm"。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setIgnoreBlank(true);
         validation.setDropDown(true);
         validation.setShowInput(true);
         validation.setInputTitle("Input");
         validation.setInputMessage("mmmmmmm");
         range.setValidation(validation);

### setInputTitle

    public void setInputTitle(java.lang.String inputTitle)

  设置提示信息的标题。

  参数：
    `inputTitle` - 输入提示信息的标题

    例子：

         //此例设置提示信息的标题为"Input"。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setIgnoreBlank(true);
         validation.setDropDown(true);
         validation.setShowInput(true);
         validation.setInputTitle("Input");
         validation.setInputMessage("mmmmmmm");
         range.setValidation(validation);

### setOperator

    public void setOperator(int operator)

  设置比较操作符。

  参数：
    `operator` - 比较操作符的类型：operator取下列值：

         OPR_BETWEEN － 介于
         OPR_NOT_BETWEEN － 不介于
         OPR_EQUALS － 等于
         OPR_NOT_EQUALS － 不等于
         OPR_GREATER_THAN － 大于
         OPR_LESS_TAHN － 小于
         OPR_GREATER_AND_EQUALS － 大于等于
         OPR_LESS_AND_EQUALS － 小于等于

    例子：

         //此例设置比较操作符为介于。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

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

### setSecondParameter

    public void setSecondParameter(java.lang.String secondPara)

  设置比较的第二个值或公式。

  参数：
    `secondPara` - 比较的第二个值或公式

    例子：

         //此例设置比较的第二个值为0.6。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

### setShowError

    public void setShowError(boolean showError)

  设置是否显示警告信息。

  参数：
    `showError` - 布尔型，如为true，当输入内容不符合校验时，弹出警告对话框；否则，不弹出警告对话框

    例子：

         //此例设置显示警告信息。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

### setShowInput

    public void setShowInput(boolean showInput)

  设置是否显示提示信息。

  参数：
    `showInput` - 布尔型，如为true，设置显示提示信息；否则不显示提示信息

    例子：

         //此例设置显示提示信息。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setIgnoreBlank(true);
         validation.setDropDown(true);
         validation.setShowInput(true);
         validation.setInputTitle("Input");
         validation.setInputMessage("mmmmmmm");
         range.setValidation(validation);

### setType

    public void setType(int type)

  设置校验的类型。

  参数：
    `type` - 校验的类型，type可取下列值：

         TYPE_ANY － 任何类型
         TYPE_INT － 整数
         TYPE_DEC － 小数
         TYPE_LIST － 列表
         TYPE_DATE － 日期
         TYPE_TIME － 时间
         TYPE_LENGTH － 文本长度
         TYPE_CUSTOM － 用户自定义

    例子：

         //此例设置校验类型为小数。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         ValidationProperties validation = new ValidationProperties();
         validation.setType(DataValidationConstants.TYPE_DEC);
         validation.setOperator(DataValidationConstants.OPR_BETWEEN);
         validation.setFirstParameter("0.3");
         validation.setSecondParameter("0.6");
         validation.setIgnoreBlank(true);
         validation.setDropDown(true);
         validation.setShowInput(true);
         validation.setInputTitle("Input");
         validation.setInputMessage("mmmmmmm");
         validation.setShowError(true);
         validation.setAlertStyle(DataValidationConstants.ALERT_STOP);
         validation.setErrorTitle("ERRER");
         validation.setErrorMessage("EEEEEEE");
         range.setValidation(validation);

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

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

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

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