Excel.CellPropertiesFont interface

Paket:
excel

Stellt die format.font Eigenschaften vongetCellProperties ,getRowProperties , undgetColumnProperties oder den format.font Eingabeparameter von setCellProperties,setRowProperties , und setColumnPropertiesdar.

Hinweise

API-Satz: ExcelApi 1.9

Verwendet von

Eigenschaften

bold

Stellt die format.font.bold Eigenschaft dar.
color

Stellt die format.font.color Eigenschaft dar.
italic

Stellt die format.font.italic Eigenschaft dar.
name

Stellt die format.font.name Eigenschaft dar.
size

Stellt die format.font.size Eigenschaft dar.
strikethrough

Stellt die format.font.strikethrough Eigenschaft dar.
subscript

Stellt die format.font.subscript Eigenschaft dar.
superscript

Stellt die format.font.superscript Eigenschaft dar.
tintAndShade

Stellt die format.font.tintAndShade Eigenschaft dar.
underline

Stellt die format.font.underline Eigenschaft dar.

Details zur Eigenschaft

bold

Stellt die format.font.bold Eigenschaft dar.

bold?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

color

Stellt die format.font.color Eigenschaft dar.

color?: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

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

Stellt die format.font.italic Eigenschaft dar.

italic?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

name

Stellt die format.font.name Eigenschaft dar.

name?: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.9

size

Stellt die format.font.size Eigenschaft dar.

size?: number;

Eigenschaftswert

number

Hinweise

API-Satz: ExcelApi 1.9

strikethrough

Stellt die format.font.strikethrough Eigenschaft dar.

strikethrough?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

subscript

Stellt die format.font.subscript Eigenschaft dar.

subscript?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

superscript

Stellt die format.font.superscript Eigenschaft dar.

superscript?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

tintAndShade

Stellt die format.font.tintAndShade Eigenschaft dar.

tintAndShade?: number;

Eigenschaftswert

number

Hinweise

API-Satz: ExcelApi 1.9

underline

Stellt die format.font.underline Eigenschaft dar.

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

Eigenschaftswert

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

Hinweise

API-Satz: ExcelApi 1.9