Вставка диапазона ячеек с помощью API JavaScript для Excel

В этой статье представлен пример кода, который вставляет диапазон ячеек с помощью API JavaScript для Excel. Полный список свойств и методов, поддерживаемых Range объектом, см . в классе Excel.Range.

Примечание.

В API JavaScript для Excel нет объекта или класса Cell. Вместо этого API JavaScript для Excel определяет все ячейки Excel как объекты Range. Отдельные ячейки в пользовательском интерфейсе Excel преобразуются в объект Range с одной ячейкой в API JavaScript для Excel. Один объект Range также может содержать несколько смежных ячеек. Дополнительные сведения см. в статье Работа с ячейками с использованием API JavaScript для Excel.

Вставка диапазона ячеек

В примере кода ниже показано, как вставить диапазон ячеек в расположение B4:E4 и сдвинуть другие ячейки вниз, чтобы освободить место для новых ячеек.

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

Данные перед вставкой диапазона

Данные после вставки диапазона

См. также

• Объектная модель JavaScript для Excel в надстройках Office
• Работа с ячейками с помощью API JavaScript для Excel
• Очистка или удаление диапазонов с помощью API JavaScript для Excel