Поделиться через


Excel.CellPropertiesFont interface

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

Комментарии

[ Набор API: ExcelApi 1.9 ]

Свойства

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

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

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 ]