Excel.CellPropertiesFill interface

パッケージ:

excel

getCellProperties 、getRowProperties、getColumnPropertiesのformat.fillプロパティ、またはsetCellProperties、setRowProperties、setColumnPropertiesのformat.fill入力パラメーターを表します。

注釈

[ API セット: ExcelApi 1.9 ]

プロパティ

color	format.fill.color プロパティを表します。
pattern	format.fill.pattern プロパティを表します。
patternColor	format.fill.patternColor プロパティを表します。
patternTintAndShade	format.fill.patternTintAndShade プロパティを表します。
tintAndShade	format.fill.tintAndShade プロパティを表します。

プロパティの詳細

color

format.fill.color プロパティを表します。

color?: string;

プロパティ値

string

注釈

[ API セット: ExcelApi 1.9 ]

例

// 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();

    // Creating the SettableCellProperties objects to use for the range.
    // In your add-in, these should be created once, outside the function.
    const topHeaderProps: Excel.SettableCellProperties = {
        // The style property takes a string matching the name of an Excel style.
        // Built-in style names are listed in the `BuiltInStyle` enum.
        // Note that a style will overwrite any formatting,
        // so do not use the format property with the style property.
        style: "Heading1"
    };

    const headerProps: Excel.SettableCellProperties = {
        // Any subproperties of format that are not set will not be changed when these cell properties are set.
        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
                }
            }
        }
    };

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

    // You can use empty JSON objects to avoid changing a cell's properties.
    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

format.fill.pattern プロパティを表します。

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

プロパティ値

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

注釈

[ API セット: ExcelApi 1.9 ]

patternColor

format.fill.patternColor プロパティを表します。

patternColor?: string;

プロパティ値

string

注釈

[ API セット: ExcelApi 1.9 ]

patternTintAndShade

format.fill.patternTintAndShade プロパティを表します。

patternTintAndShade?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.9 ]

tintAndShade

format.fill.tintAndShade プロパティを表します。

tintAndShade?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.9 ]