Compartir a través de


Borrar o eliminar intervalos mediante la API de JavaScript de Excel

En este artículo se proporcionan ejemplos de código que borran y eliminan intervalos con la API de JavaScript de Excel. Para obtener la lista completa de propiedades y métodos admitidos por el Range objeto, vea Clase Excel.Range.

Nota:

La API de JavaScript para Excel no tiene un objeto o clase de "Celda". En su lugar, se definen todas las celdas de Excel como objetos Range. Una celda individual en la interfaz de usuario de Excel se traduce en un objeto Range con una celda en la API de JavaScript para Excel. Un solo objeto Range también puede contener varias celdas contiguas. Consulte Trabajar con celdas mediante la API de JavaScript para Excel para obtener más información.

Borrar un rango de celdas

En el siguiente ejemplo de código se borra todo el contenido y el formato de las celdas del rango 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();
});

Datos antes de que se borre el rango

Datos en Excel antes de que se borre el intervalo.

Datos después de que se borre el rango

Datos en Excel después de borrar el intervalo.

Eliminar un rango de celdas

En el ejemplo de código siguiente se eliminan las celdas del rango B4:E4 y se desplazan otras celdas hacia arriba para rellenar el espacio que las celdas eliminadas desalojaron.

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

Datos antes de que se elimine el rango

Datos en Excel antes de eliminar el intervalo.

Datos después de que se elimine el rango

Datos en Excel después de eliminar el intervalo.

Vea también