Share via


Einfügen eines Zellbereichs mithilfe der Excel-JavaScript-API

Dieser Artikel enthält ein Codebeispiel, das einen Zellbereich mit der Excel-JavaScript-API einfügt. Eine vollständige Liste der Eigenschaften und Methoden, die das Range Objekt unterstützt, finden Sie in der Excel.Range-Klasse.

Hinweis

Die Excel-JavaScript-API beinhaltet keine auf „Zellen“ bezogenen Objekte oder Klassen. Stattdessen definiert die Excel-JavaScript-API alle Excel-Zellen als Objekte Range. Eine einzelne Zelle in der Excel-Benutzeroberfläche wird in ein Objekt Range mit einer Zelle der Excel-JavaScript-API übersetzt. Ein einzelnes Objekt Range kann auch mehrere zusammenhängende Zellen beinhalten. Weitere Informationen finden Sie unter Arbeiten mit Zellen mithilfe der Excel-JavaScript-API.

Einfügen eines Zellbereichs

Im folgenden Codebeispiel wird ein Zellbereich an der Position B4:E4 eingefügt. Dabei werden andere Zellen nach unten verschoben, um Platz für die neuen Zellen zu schaffen.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("B4:E4");

    range.insert(Excel.InsertShiftDirection.down);

    await context.sync();
});

Daten vor dem Einfügen des Bereichs

Daten in Excel vor dem Einfügen des Bereichs.

Daten nach dem Einfügen des Bereichs

Daten in Excel nach dem Einfügen des Bereichs.

Siehe auch