Excel.RangeTextRun interface

Stellt eine Sequenz aus einem oder mehreren Zeichen dar, die in einer Zelle dieselben Schriftartattribute aufweisen. Kann als textRuns Eigenschaften oder getCellPropertiestextRuns Eingabeparameter von setCellPropertiesverwendet werden.

Hinweise

API-Satz: ExcelApi 1.18

Verwendet von

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

    const textRunFormats: Excel.RangeTextRun[] = [
        {
            text: "Rich ",
            font: {
                bold: true,
                color: "#C00000",
                size: 14
            }
        },
        {
            text: "text",
            font: {
                color: "#4472C4",
                italic: true,
                underline: Excel.RangeUnderlineStyle.single
            }
        }
    ]
    const richTextProps: Excel.SettableCellProperties = {
        textRuns: textRunFormats
    };

    sheet.getRange("A7").setCellProperties([[richTextProps]]);
    await context.sync();
});

Eigenschaften

font

Die Schriftattribute (z. B. Schriftname, Schriftgrad und -farbe), die auf diesen Textlauf angewendet werden, werden ausgeführt.

text

Der Text dieses Textlaufs.

Details zur Eigenschaft

font

Die Schriftattribute (z. B. Schriftname, Schriftgrad und -farbe), die auf diesen Textlauf angewendet werden, werden ausgeführt.

font?: Excel.CellPropertiesFont;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.18

text

Der Text dieses Textlaufs.

text: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.18