Excel.CellBorder interface

パッケージ:

excel

getCellProperties 、getRowProperties、getColumnProperties によって返される単一の境界線のプロパティ、または setCellProperties、setRowProperties、setColumnProperties の境界プロパティ入力パラメーターを表します。

注釈

API セット: ExcelApi 1.9

使用元

• Excel.CellBorderCollection: bottom, diagonalDown, diagonalUp, horizontal, left, right, top, vertical

例

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

プロパティ

color	1 つの境界線の color プロパティを表します。
style	1 つの境界線の style プロパティを表します。
tintAndShade	1 つの境界線の tintAndShade プロパティを表します。
weight	1 つの境界線の weight プロパティを表します。

プロパティの詳細

color

1 つの境界線の color プロパティを表します。

color?: string;

プロパティ値

string

注釈

API セット: ExcelApi 1.9

style

1 つの境界線の style プロパティを表します。

style?: Excel.BorderLineStyle | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Double" | "SlantDashDot";

プロパティ値

Excel.BorderLineStyle | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Double" | "SlantDashDot"

注釈

API セット: ExcelApi 1.9

tintAndShade

1 つの境界線の tintAndShade プロパティを表します。

tintAndShade?: number;

プロパティ値

number

注釈

API セット: ExcelApi 1.9

weight

1 つの境界線の weight プロパティを表します。

weight?: Excel.BorderWeight | "Hairline" | "Thin" | "Medium" | "Thick";

プロパティ値

Excel.BorderWeight | "Hairline" | "Thin" | "Medium" | "Thick"

注釈

API セット: ExcelApi 1.9