WPS 加载项开发 > 表格 API 参考 > Validation > 方法 > Validation.Add 方法
向指定区域内添加数据有效性验证。

语法

表达式.Add(Type, AlertStyle, Operator, Formula1, Formula2)

表达式   一个代表 Validation 对象的变量。

参数

名称 必选/可选 数据类型 说明
Type 必选 XlDVType 有效性验证类型。
AlertStyle 可选 Variant 有效性验证警告的样式。可为以下 XlDVAlertStyle 常量之一:xlValidAlertInformationxlValidAlertStopxlValidAlertWarning
Operator 可选 Variant 数据有效性验证运算符。可为以下 XlFormatConditionOperator 常量之一:xlBetweenxlEqualxlGreaterxlGreaterEqualxlLessxlLessEqualxlNotBetweenxlNotEqual
Formula1 可选 Variant 数据有效性验证等式中的第一部分。
Formula2 可选 Variant OperatorxlBetweenxlNotBetween 时,数据有效性验证等式的第二部分(其他情况下,此参数被忽略)。

说明

Add 方法所要求的参数依有效性验证的类型而定,如下表所示。

有效性验证类型 参数
xlValidateCustom Formula1 必需,忽略 Formula2Formula1 必须包含一个表达式,数据项有效时该表达式的值为 True,数据项无效时,该值为 False
xlInputOnly 使用 AlertStyleFormula1Formula2
xlValidateList Formula1 必需,忽略 Formula2Formula1 必须包含以逗号分隔的值列表,或对该列表的工作表引用。
xlValidateWholeNumberxlValidateDatexlValidateDecimalxlValidateTextLengthxlValidateTime 必须指定 Formula1Formula2 之一,或两者均指定。

示例

本示例向单元格 E5 添加数据有效性验证。

示例代码
let rng = Range("e5").Validation
rng.Add(xlValidateWholeNumber,  xlValidAlertStop, xlBetween, "5", "10")
rng.InputTitle = "Integers"
rng.ErrorTitle = "Integers"
rng.InputMessage = "Enter an integer from five to ten"
rng.ErrorMessage = "You must enter a number from five to ten"


请参阅