DataValidation

DataValidation

返回数据验证对象

方法

setRule

添加或修改数据验证

语法

range.getDataValidation().setRule(DataValidationRule)

参数

属性	数据类型	必填	说明
rule	DataValidationRule	是	数据验证规则相关数据

返回值

Promise<boolean>

示例1

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 活动工作表
  const activeSheet = await activeWorkbook.getActiveSheet();
  // 区域对象
  const range = await activeWorksheet.getRange(1,2,1,2);
  // 获取数据验证对象
  const dataValidation = range.getDataValidation();
  // 数据验证规则
  const rule = { wholeNumber: { formula1: 1 , formula2: 9, operator: "between"}};
  // 新建数据验证
  dataValidation.setRule(rule);
}

示例2

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 活动工作表
  const activeSheet = await activeWorkbook.getActiveSheet();
  // 区域对象
  const rangeOption = await activeWorksheet.getRange(1,2,1,2);
  const rangeSeq = await activeWorksheet.getRange(1,3,1,3);
  // 获取数据验证对象
  const dataValidationOption = rangeOption.getDataValidation();
  const dataValidationSeq = rangeSeq.getDataValidation();
  // 数据验证规则-下拉列表（序列）
  const ruleSeq = { list: { inCellDropDown:true , showOptionList: false, source: "\"1,2,3\""} };
  // 新建数据验证
  dataValidationSeq.setRule(ruleSeq);
  // 数据验证规则-下拉列表（选项）
  const ruleOption = { list: { inCellDropDown:true , showOptionList: true, source: "\"1,2,3\""} };
  // 新建数据验证
  dataValidationOption.setRule(ruleOption);
}

clear

清除数据验证

语法

range.getDataValidation().clear()

返回值

Promise<boolean>

示例

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 活动工作表
  const activeSheet = await activeWorkbook.getActiveSheet();
  // 区域对象
  const range = await activeWorksheet.getRange(1,2,1,2);
  // 获取数据验证对象
  const dataValidation = range.getDataValidation();
  // 删除数据验证
  dataValidation.clear();
}

getRule

获取数据验证信息

语法

range.getDataValidation().getRule()

返回值

Promise<any>

示例

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 活动工作表
  const activeSheet = await activeWorkbook.getActiveSheet();
  // 区域对象
  const range = await activeWorksheet.getRange(1,1,1,1);
  // 获取数据验证对象
  const dataValidation = range.getDataValidation();
  // 获取单元格数据验证信息
  dataValidation.getRule();
}