Excel.CellPropertiesFont interface

Représente les format.font propriétés de getCellProperties,getRowProperties etgetColumnProperties ou le paramètre d’entrée format.font de setCellProperties,setRowProperties et .setColumnProperties

Propriétés

bold

Représente la format.font.bold propriété.

color

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

italic

Représente la format.font.italic propriété.

name

Représente la format.font.name propriété.

size

Représente la format.font.size propriété.

strikethrough

Représente la format.font.strikethrough propriété.

subscript

Représente la format.font.subscript propriété.

superscript

Représente la format.font.superscript propriété.

tintAndShade

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

underline

Représente la format.font.underline propriété.

Détails de la propriété

bold

Représente la format.font.bold propriété.

bold?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.9

color

Représente la format.font.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();
});

italic

Représente la format.font.italic propriété.

italic?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.9

name

Représente la format.font.name propriété.

name?: string;

Valeur de propriété

string

Remarques

Jeu d’API : ExcelApi 1.9

size

Représente la format.font.size propriété.

size?: number;

Valeur de propriété

number

Remarques

Jeu d’API : ExcelApi 1.9

strikethrough

Représente la format.font.strikethrough propriété.

strikethrough?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.9

subscript

Représente la format.font.subscript propriété.

subscript?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.9

superscript

Représente la format.font.superscript propriété.

superscript?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.9

tintAndShade

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

tintAndShade?: number;

Valeur de propriété

number

Remarques

Jeu d’API : ExcelApi 1.9

underline

Représente la format.font.underline propriété.

underline?: Excel.RangeUnderlineStyle | "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant";

Valeur de propriété

Excel.RangeUnderlineStyle | "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant"

Remarques

Jeu d’API : ExcelApi 1.9