Excel.ConditionalColorScaleCriterion interface

Paquet:
excel

Représente un critère d’échelle de couleurs qui contient un type, une valeur et une couleur.

Remarques

Ensemble d’API : ExcelApi 1.6

Utilisateur

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    const range = sheet.getRange("B2:M5");
    const conditionalFormat = range.conditionalFormats
        .add(Excel.ConditionalFormatType.colorScale);
    const criteria = {
        minimum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.lowestValue, color: "blue" },
        midpoint: { formula: "50", type: Excel.ConditionalFormatColorCriterionType.percent, color: "yellow" },
        maximum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.highestValue, color: "red" }
    };
    conditionalFormat.colorScale.criteria = criteria;

    await context.sync();
});

Propriétés

color

Représentation par code de couleur HTML de la couleur de l’échelle de couleurs (par exemple, #FF0000 représente le rouge).
formula

Un nombre, une formule ou null (si type a la valeur lowestValue).
type

Sur quoi la formule conditionnelle de critère doit être basée.

Détails de la propriété

color

Représentation par code de couleur HTML de la couleur de l’échelle de couleurs (par exemple, #FF0000 représente le rouge).

color?: string;

Valeur de propriété

string

Remarques

Ensemble d’API : ExcelApi 1.6

formula

Un nombre, une formule ou null (si type a la valeur lowestValue).

formula?: string;

Valeur de propriété

string

Remarques

Ensemble d’API : ExcelApi 1.6

type

Sur quoi la formule conditionnelle de critère doit être basée.

type: Excel.ConditionalFormatColorCriterionType | "Invalid" | "LowestValue" | "HighestValue" | "Number" | "Percent" | "Formula" | "Percentile";

Valeur de propriété

Excel.ConditionalFormatColorCriterionType | "Invalid" | "LowestValue" | "HighestValue" | "Number" | "Percent" | "Formula" | "Percentile"

Remarques

Ensemble d’API : ExcelApi 1.6