Excel.CellPropertiesFill interface

Paquet:

excel

Représente les format.fill propriétés degetCellProperties ,getRowProperties et getColumnProperties ou le paramètre d’entrée format.fill de setCellProperties, setRowPropertieset .setColumnProperties

Remarques

Jeu d’API : ExcelApi 1.9

Utilisateur

• Excel.CellPropertiesFormat :remplissage

Propriétés

color	Représente la format.fill.color propriété.
pattern	Représente la format.fill.pattern propriété.
patternColor	Représente la format.fill.patternColor propriété.
patternTintAndShade	Représente la format.fill.patternTintAndShade propriété.
tintAndShade	Représente la format.fill.tintAndShade propriété.

Détails de la propriété

color

Représente la format.fill.color propriété.

color?: string;

Valeur de propriété

string

Remarques

Jeu d’API : ExcelApi 1.9

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();

    // Create the SettableCellProperties objects for the range.
    // Create these objects once, outside the function, in your add-in.
    const topHeaderProps: Excel.SettableCellProperties = {
        // Set the style property to the name of an Excel style.
        // The `BuiltInStyle` enum lists the built-in style names.
        // A style overwrites formatting, so don't use style and format in the same object.
        style: Excel.BuiltInStyle.heading1
    };

    const headerProps: Excel.SettableCellProperties = {
        // Setting these cell properties doesn't change unspecified format subproperties.
        format: {
            fill: {
                color: "Blue"
            },
            font: {
                color: "White",
                bold: true
            }
        }
    };

    const nonApplicableProps: Excel.SettableCellProperties = {
        format: {
            fill: {
                pattern: Excel.FillPattern.gray25
            },
            font: {
                color: "Gray",
                italic: true
            }
        }
    };

    const matchupScoreProps: Excel.SettableCellProperties = {
        format: {
            borders: {
                bottom: {
                    style: Excel.BorderLineStyle.continuous
                },
                left: {
                    style: Excel.BorderLineStyle.continuous
                },
                right: {
                    style: Excel.BorderLineStyle.continuous
                },
                top: {
                    style: Excel.BorderLineStyle.continuous
                }
            },
            horizontalAlignment: Excel.HorizontalAlignment.center
        }
    };

    const range = sheet.getRange("A1:E5");

    // Use empty JSON objects to leave a cell's properties unchanged.
    range.setCellProperties([
        [topHeaderProps, {}, {}, {}, {}],
        [{}, {}, headerProps, headerProps, headerProps],
        [{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
        [{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
        [{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
    ]);

    sheet.getUsedRange().format.autofitColumns();
    await context.sync();
});

pattern

Représente la format.fill.pattern propriété.

pattern?: Excel.FillPattern | "None" | "Solid" | "Gray50" | "Gray75" | "Gray25" | "Horizontal" | "Vertical" | "Down" | "Up" | "Checker" | "SemiGray75" | "LightHorizontal" | "LightVertical" | "LightDown" | "LightUp" | "Grid" | "CrissCross" | "Gray16" | "Gray8" | "LinearGradient" | "RectangularGradient";

Valeur de propriété

Excel.FillPattern | "None" | "Solid" | "Gray50" | "Gray75" | "Gray25" | "Horizontal" | "Vertical" | "Down" | "Up" | "Checker" | "SemiGray75" | "LightHorizontal" | "LightVertical" | "LightDown" | "LightUp" | "Grid" | "CrissCross" | "Gray16" | "Gray8" | "LinearGradient" | "RectangularGradient"

Remarques

Jeu d’API : ExcelApi 1.9

patternColor

Représente la format.fill.patternColor propriété.

patternColor?: string;

Valeur de propriété

string

Remarques

Jeu d’API : ExcelApi 1.9

patternTintAndShade

Représente la format.fill.patternTintAndShade propriété.

patternTintAndShade?: number;

Valeur de propriété

number

Remarques

Jeu d’API : ExcelApi 1.9

tintAndShade

Représente la format.fill.tintAndShade propriété.

tintAndShade?: number;

Valeur de propriété

number

Remarques

Jeu d’API : ExcelApi 1.9