Очистка или удаление диапазонов с помощью 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.

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

В примере кода ниже показано, как удалить все содержимое и форматирование ячеек в диапазоне E2:E5.

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

    range.clear();

    await context.sync();
});

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

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

Удаление диапазона ячеек

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

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

    range.delete(Excel.DeleteShiftDirection.up);

    await context.sync();
});

Данные перед удалением диапазона

Данные после удаления диапазона

См. также

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