Excel.BasicDataValidation interface

Représente les critères de validation des données de type de base.

Remarques

Jeu d’API : ExcelApi 1.8

Utilisateur

Exemples

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

function applyDecimal(sheet: Excel.Worksheet) {
    // Decimal values between 0 and 10 are allowed.
    const basicRule: Excel.BasicDataValidation = {
        formula1: 0,
        formula2: 10,
        operator: Excel.DataValidationOperator.between
    };
    const rule: Excel.DataValidationRule = { decimal: basicRule };
    sheet.getRange("B3").dataValidation.rule = rule;
}

Propriétés

formula1

Spécifie l’opérande de droite lorsque la propriété de l’opérateur est définie sur un opérateur binaire tel que Supérieur à (l’opérande de gauche est la valeur que l’utilisateur tente d’entrer dans la cellule). Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite inférieure. Par exemple, définir la formule 1 sur 10 et l’opérateur sur Supérieur à signifie que les données valides pour la plage doivent être supérieures à 10. Lors de la définition de la valeur, elle peut être transmise sous forme de nombre, d’objet de plage ou de formule de chaîne (où la chaîne est soit un nombre converti en chaîne, soit une référence de cellule telle que « =A1 », soit une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

formula2

Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite supérieure. N’est pas utilisé avec les opérateurs binaires, tels que Supérieur à. Lors de la définition de la valeur, elle peut être transmise sous forme de nombre, d’objet de plage ou de formule de chaîne (où la chaîne est soit un nombre converti en chaîne, soit une référence de cellule telle que « =A1 », soit une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

operator

L’opérateur à utiliser pour la validation des données.

Détails de la propriété

formula1

Spécifie l’opérande de droite lorsque la propriété de l’opérateur est définie sur un opérateur binaire tel que Supérieur à (l’opérande de gauche est la valeur que l’utilisateur tente d’entrer dans la cellule). Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite inférieure. Par exemple, définir la formule 1 sur 10 et l’opérateur sur Supérieur à signifie que les données valides pour la plage doivent être supérieures à 10. Lors de la définition de la valeur, elle peut être transmise sous forme de nombre, d’objet de plage ou de formule de chaîne (où la chaîne est soit un nombre converti en chaîne, soit une référence de cellule telle que « =A1 », soit une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

formula1: string | number | Range;

Valeur de propriété

string | number | Excel.Range

Remarques

Jeu d’API : ExcelApi 1.8

formula2

Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite supérieure. N’est pas utilisé avec les opérateurs binaires, tels que Supérieur à. Lors de la définition de la valeur, elle peut être transmise sous forme de nombre, d’objet de plage ou de formule de chaîne (où la chaîne est soit un nombre converti en chaîne, soit une référence de cellule telle que « =A1 », soit une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

formula2?: string | number | Range;

Valeur de propriété

string | number | Excel.Range

Remarques

Jeu d’API : ExcelApi 1.8

operator

L’opérateur à utiliser pour la validation des données.

operator: Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo";

Valeur de propriété

Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo"

Remarques

Jeu d’API : ExcelApi 1.8