Class DataValidation

DataValidation

存取資料驗證規則。如要建立新規則，請使用 SpreadsheetApp.newDataValidation() 和 DataValidationBuilder。別擔心！您可以使用 Range.setDataValidation(rule)：設定範圍的驗證規則。

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

方法

方法	傳回類型	簡短說明
copy()	DataValidationBuilder	根據這項規則設定建立資料驗證規則的建構工具。
getAllowInvalid()	Boolean	如果規則在輸入失敗資料驗證時顯示警告，則傳回 true；如果規則完全拒絕輸入，則傳回 false。
getCriteriaType()	DataValidationCriteria	取得 DataValidationCriteria 列舉中定義的規則條件類型。
getCriteriaValues()	Object[]	取得規則條件的引數陣列。
getHelpText()	String	取得規則的說明文字；如果沒有設定說明文字，則取得 null。

內容詳盡的說明文件

copy()

根據這項規則設定建立資料驗證規則的建構工具。

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

回攻員

DataValidationBuilder：根據這項規則設定建立的建構工具

---

getAllowInvalid()

如果規則在輸入失敗資料驗證時顯示警告，則傳回 true；如果規則完全拒絕輸入，則傳回 false。新資料驗證規則的預設值為 true。

回攻員

Boolean — true：如果規則允許輸入失敗資料驗證；如果不需要，則設為false

---

getCriteriaType()

取得 DataValidationCriteria 列舉中定義的規則條件類型。若要取得 要查詢條件的引數，請使用 getCriteriaValues()。如要使用這些值來建立或 修改資料驗證規則，請參閱 DataValidationBuilder.withCriteria(criteria, args)。

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

回攻員

DataValidationCriteria：資料驗證條件的類型

---

getCriteriaValues()

取得規則條件的引數陣列。如要取得條件類型，請使用 getCriteriaType()。如要使用這些值建立或修改資料驗證規則，請參閱 DataValidationBuilder.withCriteria(criteria, args)。

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

回攻員

Object[]：符合規則條件類型的一組引數。引數的數量 而且類型符合 DataValidationBuilder 類別的對應 require...() 方法

---

getHelpText()

取得規則的說明文字；如果沒有設定說明文字，則取得 null。

回攻員

String：規則的說明文字；如果未設定說明文字，則為 null