Inserción de un rango de celdas mediante la API de JavaScript de Excel

En este artículo se proporciona un ejemplo de código que inserta un rango de celdas con la API de JavaScript de Excel. Para obtener la lista completa de propiedades y métodos que admite el Range objeto, vea la 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.

Insertar un rango de celdas

En el ejemplo de código siguiente se inserta un rango de celdas en la ubicación B4:E4 y se desplazan las demás celdas hacia abajo para proporcionar espacio a las nuevas celdas.

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

Datos antes de que se inserte el rango

Datos después de que se inserte el rango

Vea también

• Modelo de objetos de JavaScript en Excel para Complementos de Office
• Trabajo con celdas mediante la API de JavaScript de Excel
• Borrar o eliminar intervalos mediante la API de JavaScript de Excel