ExcelScript.BasicDataValidation interface

Pacote:

ExcelScript

Representa os critérios básicos de validação de dados de tipo.

Comentários

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 à direita quando a propriedade do operador é definida como um operador binário como GreaterThan (o operando à esquerda é 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órmula 1 a 10 e o operador como GreaterThan 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 stringizado, 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", "=SUM(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 stringizado, 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", "=SUM(A1:B5)", etc.
operator	O operador a ser usado para validar os dados.

Detalhes da propriedade

formula1

Especifica o operando à direita quando a propriedade do operador é definida como um operador binário como GreaterThan (o operando à esquerda é 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órmula 1 a 10 e o operador como GreaterThan 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 stringizado, 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", "=SUM(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 stringizado, 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", "=SUM(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;

Valor da propriedade

ExcelScript.DataValidationOperator