Excel.DataValidationErrorAlert interface

Pacote:

excel

Representa as propriedades do alerta de erro para a validação de dados.

Comentários

[ Conjunto de API: ExcelApi 1.8 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Decision");
    const rankingRange = sheet.tables.getItem("NameOptionsTable").columns.getItem("Ranking").getDataBodyRange();

    // When you are developing, it is a good practice to
    // clear the dataValidation object with each run of your code.
    rankingRange.dataValidation.clear();

    let greaterThanZeroRule = {
        wholeNumber: {
            formula1: 0,
            operator: Excel.DataValidationOperator.greaterThan
        }
    };
    rankingRange.dataValidation.rule = greaterThanZeroRule;

    rankingRange.dataValidation.prompt = {
        message: "Please enter a positive number.",
        showPrompt: true,
        title: "Positive numbers only."
    };

    rankingRange.dataValidation.errorAlert = {
        message: "Sorry, only positive numbers are allowed",
        showAlert: true,
        style: "Stop",
        title: "Negative Number Entered"
    };

    await context.sync();
});

Propriedades

message	Representa a mensagem de alerta de erro.
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.
style	O tipo de alerta de validação de dados, veja Excel.DataValidationAlertStyle para obter detalhes.
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

Comentários

[ Conjunto de API: ExcelApi 1.8 ]

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

Comentários

[ Conjunto de API: ExcelApi 1.8 ]

style

O tipo de alerta de validação de dados, veja Excel.DataValidationAlertStyle para obter detalhes.

style: Excel.DataValidationAlertStyle | "Stop" | "Warning" | "Information";

Valor da propriedade

Excel.DataValidationAlertStyle | "Stop" | "Warning" | "Information"

Comentários

[ Conjunto de API: ExcelApi 1.8 ]

title

Representa o título da caixa de diálogo de alerta de erro.

title: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.8 ]