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

En este artículo se proporcionan ejemplos de código que insertan 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.

Puntos clave

• Use Range.insert para agregar nuevas celdas y desplazar las celdas existentes para dejar espacio.
• Especifique la dirección del desplazamiento: hacia abajo o hacia la derecha.
• Las celdas existentes se mueven para acomodar las nuevas celdas vacías.
• Las fórmulas con referencias de celda se ajustan automáticamente después de la inserción.

Insertar un rango de celdas

El Range.insert método agrega nuevas celdas vacías a la hoja de cálculo y desplaza las celdas existentes para dejar espacio. Debe especificar qué dirección desplazar las celdas existentes: hacia abajo o hacia la derecha. Esto resulta útil al agregar datos al medio del contenido existente sin sobrescribirlos.

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
• Establecimiento y obtención de valores de rango, texto o fórmulas mediante la API de JavaScript de Excel
• Cortar, copiar y pegar intervalos mediante la API de JavaScript de Excel