เข้าถึงกฎการตรวจสอบข้อมูล หากต้องการสร้างกฎใหม่ ให้ใช้ 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 | รับประเภทเกณฑ์ของกฎตามที่ระบุไว้ใน enum ของ 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()
รับประเภทเกณฑ์ของกฎตามที่ระบุไว้ใน enum ของ 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[]
— อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ของกฎ จำนวนอาร์กิวเมนต์
และประเภทของพวกเขาตรงกับเมธอด require...()
ที่สอดคล้องกันของคลาส DataValidationBuilder
getHelpText()
รับข้อความช่วยเหลือของกฎ หรือ null
หากไม่มีการตั้งค่าข้อความช่วยเหลือไว้
รีเทิร์น
String
— ข้อความช่วยเหลือของกฎ หรือ null
หากไม่ได้ตั้งข้อความช่วยเหลือไว้