Inserir um intervalo de células usando a API JavaScript do Excel

Este artigo fornece um exemplo de código que insere um intervalo de células com a API JavaScript do Excel. Para obter a lista completa de propriedades e métodos compatíveis com o Range objeto, consulte a classe Excel.Range.

Observação

A API JavaScript do Excel não tem um objeto ou classe "Célula". Em vez disso, a API JavaScript do Excel define todas as células do Excel como objetos Range. Uma célula individual na interface do usuário do Excel se traduz em um objeto Range com uma célula na API JavaScript do Excel. Um único objeto Range também pode conter várias células contíguas. Confira Trabalhar com células usando a API JavaScript do Excel para saber mais.

Inserir um intervalo de células

O exemplo de código a seguir insere um intervalo de células no local B4:E4 e desloca outras células para baixo a fim de fornecer espaço para as novas células.

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

Dados antes da inserção do intervalo

Dados no Excel antes do intervalo ser inserido.

Dados após a inserção do intervalo

Os dados no Excel após o intervalo são inseridos.

Confira também