ExcelScript.BasicDataValidation interface
Representa os critérios básicos de validação de dados de tipo.
Comentários
Usada por
Exemplos
/**
* This script creates a data validation rule for the range B1:B5.
* All values in that range must be a positive number.
* Attempts to enter other values are blocked and an error message appears.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the range B1:B5 in the active worksheet.
const currentSheet = workbook.getActiveWorksheet();
const positiveNumberOnlyCells = currentSheet.getRange("B1:B5");
// Create a data validation rule to only allow positive numbers.
const positiveNumberValidation: ExcelScript.BasicDataValidation = {
formula1: "0",
operator: ExcelScript.DataValidationOperator.greaterThan
};
const positiveNumberOnlyRule: ExcelScript.DataValidationRule = {
wholeNumber: positiveNumberValidation
};
// Set the rule on the range.
const rangeDataValidation = positiveNumberOnlyCells.getDataValidation();
rangeDataValidation.setRule(positiveNumberOnlyRule);
// Create an alert to appear when data other than positive numbers are entered.
const positiveNumberOnlyAlert: ExcelScript.DataValidationErrorAlert = {
message: "Positive numbers only",
showAlert: true,
style: ExcelScript.DataValidationAlertStyle.stop,
title: "Invalid data"
};
rangeDataValidation.setErrorAlert(positiveNumberOnlyAlert);
}
Propriedades
| formula1 | Especifica o operando direito quando a propriedade operator é definida como um operador binário, como GreaterThan (o operando esquerdo é o valor que o usuário tenta inserir na célula). Com os operadores ternários Between e NotBetween, especifica o operando de limite inferior. Por exemplo, definir a fórmula1 como 10 e o operador como MaiorThan significa que os dados válidos para o intervalo devem ser maiores que 10. Ao definir o valor, ele pode ser passado como um número, um objeto de intervalo ou uma fórmula de cadeia de caracteres (em que a cadeia de caracteres é um número em cadeia de caracteres, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SOMA(A1:B5)", etc. |
| formula2 | Com os operadores ternários Between e NotBetween, especifica o operando de limite superior. Não é usado com os operadores binários, como GreaterThan. Ao definir o valor, ele pode ser passado como um número, um objeto de intervalo ou uma fórmula de cadeia de caracteres (em que a cadeia de caracteres é um número em cadeia de caracteres, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SOMA(A1:B5)", etc. |
| operator | O operador a ser usado para validar os dados. |
Detalhes da propriedade
formula1
Especifica o operando direito quando a propriedade operator é definida como um operador binário, como GreaterThan (o operando esquerdo é o valor que o usuário tenta inserir na célula). Com os operadores ternários Between e NotBetween, especifica o operando de limite inferior. Por exemplo, definir a fórmula1 como 10 e o operador como MaiorThan significa que os dados válidos para o intervalo devem ser maiores que 10. Ao definir o valor, ele pode ser passado como um número, um objeto de intervalo ou uma fórmula de cadeia de caracteres (em que a cadeia de caracteres é um número em cadeia de caracteres, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SOMA(A1:B5)", etc.
formula1: string | number | Range;Valor da propriedade
string | number | ExcelScript.Range
formula2
Com os operadores ternários Between e NotBetween, especifica o operando de limite superior. Não é usado com os operadores binários, como GreaterThan. Ao definir o valor, ele pode ser passado como um número, um objeto de intervalo ou uma fórmula de cadeia de caracteres (em que a cadeia de caracteres é um número em cadeia de caracteres, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SOMA(A1:B5)", etc.
formula2?: string | number | Range;Valor da propriedade
string | number | ExcelScript.Range
operator
O operador a ser usado para validar os dados.
operator: DataValidationOperator;