Построитель правил проверки данных.
// Set the data validation for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
build() | DataValidation | Создает правило проверки данных на основе настроек, примененных к построителю. |
copy() | DataValidationBuilder | Создает построитель для правила проверки данных на основе настроек этого правила. |
getAllowInvalid() | Boolean | Возвращает true если правило отображает предупреждение, когда входные данные не проходят проверку, или false если входные данные полностью отклоняются. |
getCriteriaType() | DataValidationCriteria | Получает тип критерия правила, определенный в перечислении DataValidationCriteria . |
getCriteriaValues() | Object[] | Получает массив аргументов для критериев правила. |
getHelpText() | String | Получает текст справки по правилу или null , если текст справки не задан. |
requireCheckbox() | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были логическими значениями; это значение отображается как флажок. |
requireCheckbox(checkedValue) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были указанным значением или пустым. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были одним из указанных значений. |
requireDate() | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату. |
requireDateAfter(date) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату после заданного значения. |
requireDateBefore(date) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату перед заданным значением. |
requireDateBetween(start, end) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату, которая находится между двумя указанными датами или является одной из них. |
requireDateEqualTo(date) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату, равную заданному значению. |
requireDateNotBetween(start, end) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату, которая не попадает между двумя указанными датами и не является ни одной из них. |
requireDateOnOrAfter(date) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату, соответствующую заданному значению или после него. |
requireDateOnOrBefore(date) | DataValidationBuilder | Устанавливает правило проверки данных, требующее дату, соответствующую или предшествующую заданному значению. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы данная формула имела значение true . |
requireNumberBetween(start, end) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, находящееся между двумя указанными числами или являющееся одним из них. |
requireNumberEqualTo(number) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, равное заданному значению. |
requireNumberGreaterThan(number) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, превышающее заданное значение. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, большее или равное заданному значению. |
requireNumberLessThan(number) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число меньше заданного значения. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, меньшее или равное заданному значению. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, которое не находится между двумя указанными числами и не является ни одним из них. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Устанавливает правило проверки данных, требующее число, не равное заданному значению. |
requireTextContains(text) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные содержали заданное значение. |
requireTextDoesNotContain(text) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные не содержали заданное значение. |
requireTextEqualTo(text) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были равны заданному значению. |
requireTextIsEmail() | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были в форме адреса электронной почты. |
requireTextIsUrl() | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были в форме URL-адреса. |
requireValueInList(values) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были равны одному из заданных значений. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были равны одному из заданных значений, с возможностью скрыть раскрывающееся меню. |
requireValueInRange(range) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были равны значению в заданном диапазоне. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Устанавливает правило проверки данных, требующее, чтобы входные данные были равны значению в заданном диапазоне, с возможностью скрыть раскрывающееся меню. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Устанавливает, отображать ли предупреждение, когда вводимые данные не проходят проверку, или полностью отклонять ввод. |
setHelpText(helpText) | DataValidationBuilder | Устанавливает текст справки, который появляется, когда пользователь наводит указатель мыши на ячейку, для которой настроена проверка данных. |
withCriteria(criteria, args) | DataValidationBuilder | Задает для правила проверки данных критерии, определенные значениями DataValidationCriteria , которые обычно берутся из criteria и arguments существующего правила. |
Подробная документация
build()
Создает правило проверки данных на основе настроек, примененных к построителю.
Возвращаться
DataValidation
— представление правила проверки данных.
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()
. Чтобы использовать эти значения для создания или изменения правила проверки данных, см. 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()
. Чтобы использовать эти значения для создания или изменения правила проверки данных, см. 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
, если текст справки не задан.
requireCheckbox()
Устанавливает правило проверки данных, требующее, чтобы входные данные были логическим значением; это значение отображается как флажок.
// Set the data validation for cell A1 to require a boolean value; the value is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build(); cell.setDataValidation(rule);
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireCheckbox(checkedValue)
Устанавливает правило проверки данных, требующее, чтобы входные данные были указанным значением или пустым. Когда входные данные соответствуют указанному значению, ячейка отображается как установленный флажок. Если ввод пуст, ячейка отображается как неотмеченный флажок.
// Set the data validation for cell A1 to require a custom checked value that is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
checkedValue | Object | Значение, присвоенное отмеченному флажку. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireCheckbox(checkedValue, uncheckedValue)
Устанавливает правило проверки данных, требующее, чтобы входные данные были одним из указанных значений. Когда входное значение имеет checkedValue
ячейка отображается как отмеченный флажок. Если введено значение uncheckedValue
ячейка отображается как неотмеченный флажок.
// Set the data validation for cell A1 to require custom checked values that are rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
checkedValue | Object | Значение, присвоенное отмеченному флажку. |
uncheckedValue | Object | Значение, присвоенное неустановленному флажку. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireDate()
Устанавливает правило проверки данных, требующее дату.
// Set the data validation for cell A1 to require a date. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDate().build(); cell.setDataValidation(rule);
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireDateAfter(date)
Устанавливает правило проверки данных, требующее дату после заданного значения. Поля времени объекта Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
date | Date | Последняя неприемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
requireDateBefore(date)
Устанавливает правило проверки данных, требующее дату перед заданным значением. Поля времени объекта Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
date | Date | Самая ранняя неприемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireDateBetween(start, end)
Устанавливает правило проверки данных, требующее дату, которая находится между двумя указанными датами или является одной из них. Поля времени объектов Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Date | Самая ранняя приемлемая дата. |
end | Date | Самая поздняя приемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
requireDateEqualTo(date)
Устанавливает правило проверки данных, требующее дату, равную заданному значению. Поля времени объекта Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date equal to January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013')) .build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
date | Date | Единственная приемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
requireDateNotBetween(start, end)
Устанавливает правило проверки данных, требующее дату, которая не попадает между двумя указанными датами и не является ни одной из них. Поля времени объектов Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date not in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Date | Самая ранняя неприемлемая дата. |
end | Date | Последняя неприемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
requireDateOnOrAfter(date)
Устанавливает правило проверки данных, требующее дату, соответствующую заданному значению или после него. Поля времени объекта Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date on or after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
date | Date | Самая ранняя приемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireDateOnOrBefore(date)
Устанавливает правило проверки данных, требующее дату, соответствующую или предшествующую заданному значению. Поля времени объекта Date
игнорируются; используются только поля дня, месяца и года.
// Set the data validation for cell A1 to require a date on or before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
date | Date | Самая поздняя приемлемая дата. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireFormulaSatisfied(formula)
Устанавливает правило проверки данных, требующее, чтобы данная формула имела значение true
.
// Set the data validation for cell A1 to equal B1 with a custom formula. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
formula | String | Пользовательская формула, которая возвращает true если введенные данные действительны. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberBetween(start, end)
Устанавливает правило проверки данных, требующее число, находящееся между двумя указанными числами или являющееся одним из них.
// Set the data validation for cell A1 to require a number between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Number | Наименьшее приемлемое значение. |
end | Number | Максимально допустимое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberEqualTo(number)
Устанавливает правило проверки данных, требующее число, равное заданному значению.
// Set the data validation for cell A1 to require a number equal to 3.1415926536. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
number | Number | Единственное приемлемое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberGreaterThan(number)
Устанавливает правило проверки данных, требующее число, превышающее заданное значение.
// Set the data validation for cell A1 to require a number greater than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
number | Number | Высшее недопустимое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberGreaterThanOrEqualTo(number)
Устанавливает правило проверки данных, требующее число, большее или равное заданному значению.
// Set the data validation for cell A1 to require a number greater than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
number | Number | Наименьшее приемлемое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberLessThan(number)
Устанавливает правило проверки данных, требующее число меньше заданного значения.
// Set the data validation for cell A1 to require a number less than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
number | Number | Наименьшее неприемлемое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberLessThanOrEqualTo(number)
Устанавливает правило проверки данных, требующее число, меньшее или равное заданному значению.
// Set the data validation for cell A1 to require a number less than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
number | Number | Максимально допустимое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberNotBetween(start, end)
Устанавливает правило проверки данных, требующее число, которое не находится между двумя указанными числами и не является ни одним из них.
// Set the data validation for cell A1 to require a number not between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Number | Наименьшее неприемлемое значение. |
end | Number | Высшее недопустимое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireNumberNotEqualTo(number)
Устанавливает правило проверки данных, требующее число, не равное заданному значению.
// Set the data validation for cell A1 to require a number not equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
number | Number | Единственная неприемлемая ценность. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
requireTextContains(text)
Устанавливает правило проверки данных, требующее, чтобы входные данные содержали заданное значение.
// Set the data validation for cell A1 to require any value that includes "Google". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Значение, которое должно содержать входные данные. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireTextDoesNotContain(text)
Устанавливает правило проверки данных, требующее, чтобы входные данные не содержали заданное значение.
// Set the data validation for cell A1 to require any value that does not include "@". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Значение, которое входные данные не должны содержать. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireTextEqualTo(text)
Устанавливает правило проверки данных, требующее, чтобы входные данные были равны заданному значению.
// Set the data validation for cell A1 to require "Yes". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Единственное приемлемое значение. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireTextIsEmail()
Устанавливает правило проверки данных, требующее, чтобы входные данные были в форме адреса электронной почты.
// Set the data validation for cell A1 to require text in the form of an email address. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build(); cell.setDataValidation(rule);
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireTextIsUrl()
Устанавливает правило проверки данных, требующее, чтобы входные данные были в форме URL-адреса.
// Set the data validation for cell A1 to require text in the form of a URL. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build(); cell.setDataValidation(rule);
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireValueInList(values)
Устанавливает правило проверки данных, требующее, чтобы входные данные были равны одному из заданных значений.
// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
values | String[] | Массив допустимых значений. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireValueInList(values, showDropdown)
Устанавливает правило проверки данных, требующее, чтобы входные данные были равны одному из заданных значений, с возможностью скрыть раскрывающееся меню.
// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
values | String[] | Массив допустимых значений. |
showDropdown | Boolean | true , если в электронной таблице должно отображаться раскрывающееся меню для значений; false , если нет. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireValueInRange(range)
Устанавливает правило проверки данных, требующее, чтобы входные данные были равны значению в заданном диапазоне.
// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
range | Range | Диапазон, содержащий допустимые значения. |
Возвращаться
DataValidationBuilder
— этот конструктор для цепочки
requireValueInRange(range, showDropdown)
Устанавливает правило проверки данных, требующее, чтобы входные данные были равны значению в заданном диапазоне, с возможностью скрыть раскрывающееся меню.
// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build(); cell.setDataValidation(rule);
Параметры
Имя | Тип | Описание |
---|---|---|
range | Range | Диапазон, содержащий допустимые значения. |
showDropdown | Boolean | true , если в электронной таблице должно отображаться раскрывающееся меню для значений; false , если нет. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
setAllowInvalid(allowInvalidData)
Устанавливает, отображать ли предупреждение, когда вводимые данные не проходят проверку, или полностью отклонять ввод. По умолчанию для новых правил проверки данных установлено true
.
Параметры
Имя | Тип | Описание |
---|---|---|
allowInvalidData | Boolean | true , если правило должно разрешать ввод данных, не прошедший проверку данных; false , если нет. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
setHelpText(helpText)
Устанавливает текст справки, который появляется, когда пользователь наводит указатель мыши на ячейку, для которой настроена проверка данных.
Параметры
Имя | Тип | Описание |
---|---|---|
helpText | String | Текст справки для установки. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания
withCriteria(criteria, args)
Задает для правила проверки данных критерии, определенные значениями DataValidationCriteria
, которые обычно берутся из criteria
и arguments
существующего правила.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
criteria | DataValidationCriteria | Тип критериев проверки данных. |
args | Object[] | Массив аргументов, соответствующих типу критерия; количество аргументов и их тип соответствуют соответствующему методу require...() указанному выше. |
Возвращаться
DataValidationBuilder
— этот конструктор для связывания