命名空间: DataValidation

Spread.Sheets.DataValidation

Table of contents

枚举

• CriteriaType
• DataValidationResult
• ErrorStyle
• HighlightPosition
• HighlightType

类

• DefaultDataValidator

接口

• IHighLightStyle

函数

• createDateValidator
• createFormulaListValidator
• createFormulaValidator
• createListValidator
• createNumberValidator
• createTextLengthValidator
• createTimeValidator

Functions

createDateValidator

▸ createDateValidator(typeOperator, v1, v2?): DefaultDataValidator

创建日期数据验证

static

代码示例

spread.options.highlightInvalidData = true;
var dv = GC.Spread.Sheets.DataValidation.createDateValidator(GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.between, new Date(2012, 11, 31), new Date(2013, 11, 31));
dv.showInputMessage(true);
dv.inputMessage("Enter a date between 12/31/2012 and 12/31/2013.");
dv.inputTitle("Tip");
activeSheet.getCell(1, -1).validator(dv);

参数

属性名	类型	说明
typeOperator	ComparisonOperators	CompareOperators的比较运算符
v1	Object	第一个对象
v2?	Object	第二个对象

返回值

DefaultDataValidator

数据验证

---

createFormulaListValidator

▸ createFormulaListValidator(formula): DefaultDataValidator

创建公式列表数据验证

static

代码示例

activeSheet.setValue(0, 2, 5);
activeSheet.setValue(1, 2, 4);
activeSheet.setValue(2, 2, 5);
spread.options.highlightInvalidData = true;
var dv = GC.Spread.Sheets.DataValidation.createFormulaListValidator("$C$1:$C$3");
dv.showInputMessage(true);
dv.inputMessage("Pick a value from the list.");
dv.inputTitle("tip");
activeSheet.setDataValidator(1, 1, 1,1,dv,GC.Spread.Sheets.SheetArea.viewport);
var validList = activeSheet.getDataValidator(1, 1).getValidList(activeSheet, 1, 1);
alert(validList);

参数

属性名	类型	说明
formula	string	公式列表

返回值

DefaultDataValidator

数据验证

---

createFormulaValidator

▸ createFormulaValidator(formula): DefaultDataValidator

创建公式数据验证

static

代码示例

spread.options.highlightInvalidData = true;
//如果公式条件返回true,则公式验证有效
var dv = GC.Spread.Sheets.DataValidation.createFormulaValidator("A1>0");
dv.showInputMessage(true);
dv.inputMessage("Enter a value greater than 0 in A1.");
dv.inputTitle("Tip");
activeSheet.setDataValidator(0, 0, 1,1,dv,GC.Spread.Sheets.SheetArea.viewport);

参数

属性名	类型	说明
formula	string	公式条件

返回值

DefaultDataValidator

数据验证

---

createListValidator

▸ createListValidator(source): DefaultDataValidator

创建序列数据验证

static

代码示例

spread.options.highlightInvalidData = true;
var dv = GC.Spread.Sheets.DataValidation.createListValidator("1,2,3");
dv.showInputMessage(true);
dv.inputMessage("Value must be 1,2 or 3");
dv.inputTitle("tip");
activeSheet.setDataValidator(1,1,1,1,dv, GC.Spread.Sheets.SheetArea.viewport);
alert(activeSheet.getDataValidator(1,1).getValidList(activeSheet,1,1));

参数

属性名	类型	说明
source	string	序列值

返回值

DefaultDataValidator

数据验证

---

createNumberValidator

▸ createNumberValidator(typeOperator, v1, v2, isIntegerValue): DefaultDataValidator

创建整数数据验证

static

代码示例

spread.options.highlightInvalidData = true;
var dv = GC.Spread.Sheets.DataValidation.createNumberValidator(GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.between, "5", "20", true);
dv.showInputMessage(true);
dv.inputMessage("Value must be between 5 and 20.");
dv.inputTitle("tip");
activeSheet.setDataValidator(1, 1, 1,1,dv,GC.Spread.Sheets.SheetArea.viewport);

参数

属性名	类型	说明
typeOperator	ComparisonOperators	CompareOperators的比较运算符
v1	Object	第一个对象
v2?	Object	第二个对象
isIntegerValue?	boolean	设为true则是整数数据验证

返回值

DefaultDataValidator

数据验证

---

createTextLengthValidator

▸ createTextLengthValidator(typeOperator, v1, v2): DefaultDataValidator

创建文本长度数据验证

static

代码示例

spread.options.highlightInvalidData = true;
var dv = GC.Spread.Sheets.DataValidation.createTextLengthValidator(GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.greaterThan, "4", "20");
dv.showInputMessage(true);
dv.inputMessage("Number of characters must be greater than 4.");
dv.inputTitle("tip");
activeSheet.setDataValidator(1, 1, 1, 1, dv, GC.Spread.Sheets.SheetArea.viewport);

参数

属性名	类型	说明
typeOperator	ComparisonOperators	CompareOperators的比较运算符
v1	Object	第一个对象
v2	Object	第二个对象

返回值

DefaultDataValidator

数据验证

---

createTimeValidator

▸ createTimeValidator(typeOperator, v1, v2): DefaultDataValidator

创建时间数据验证

static

代码示例

spread.options.highlightInvalidData = true;
var dv = GC.Spread.Sheets.DataValidation.createTimeValidator(GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.between, '9:08:09', '19:08:09');
dv.showInputMessage(true);
dv.inputMessage("Enter a time between 9:08:09 and 19:08:09.");
dv.inputTitle("Tip");
sheet.setDataValidator(1, 1, dv);

参数

属性名	类型	说明
typeOperator	ComparisonOperators	CompareOperators的比较运算符
v1	Object	第一个对象
v2?	Object	第二个对象

返回值

DefaultDataValidator

数据验证