Excel.CellPropertiesFont interface

Представляет format.font свойства getCellProperties,getRowProperties и getColumnProperties, или входной format.font параметр setCellProperties,setRowProperties , и .setColumnProperties

Свойства

bold

Представляет свойство format.font.bold.

color

Представляет свойство format.font.color.

italic

Представляет свойство format.font.italic.

name

Представляет свойство format.font.name.

size

Представляет свойство format.font.size.

strikethrough

Представляет свойство format.font.strikethrough.

subscript

Представляет свойство format.font.subscript.

superscript

Представляет свойство format.font.superscript.

tintAndShade

Представляет свойство format.font.tintAndShade.

underline

Представляет свойство format.font.underline.

Сведения о свойстве

bold

Представляет свойство format.font.bold.

bold?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.9

color

Представляет свойство format.font.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();

    // 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

Представляет свойство format.font.italic.

italic?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.9

name

Представляет свойство format.font.name.

name?: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.9

size

Представляет свойство format.font.size.

size?: number;

Значение свойства

number

Комментарии

Набор API: ExcelApi 1.9

strikethrough

Представляет свойство format.font.strikethrough.

strikethrough?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.9

subscript

Представляет свойство format.font.subscript.

subscript?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.9

superscript

Представляет свойство format.font.superscript.

superscript?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.9

tintAndShade

Представляет свойство format.font.tintAndShade.

tintAndShade?: number;

Значение свойства

number

Комментарии

Набор API: ExcelApi 1.9

underline

Представляет свойство format.font.underline.

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

Значение свойства

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

Комментарии

Набор API: ExcelApi 1.9