ExcelScript.DataValidationErrorAlert interface
Representa as propriedades do alerta de erro para a validação de dados.
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
message | Representa a mensagem de alerta de erro. |
show |
Especifica se pretende mostrar uma caixa de diálogo de alerta de erro quando um utilizador introduz dados inválidos. A predefinição é |
style | O tipo de alerta de validação de dados, veja |
title | Representa o título da caixa de diálogo de alerta de erro. |
Detalhes da propriedade
message
Representa a mensagem de alerta de erro.
message: string;
Valor da propriedade
string
showAlert
Especifica se pretende mostrar uma caixa de diálogo de alerta de erro quando um utilizador introduz dados inválidos. A predefinição é true
.
showAlert: boolean;
Valor da propriedade
boolean
style
O tipo de alerta de validação de dados, veja ExcelScript.DataValidationAlertStyle
para obter detalhes.
style: DataValidationAlertStyle;
Valor da propriedade
title
Representa o título da caixa de diálogo de alerta de erro.
title: string;
Valor da propriedade
string