Limpar ou excluir intervalos usando a API JavaScript do Excel

  • Artigo

Este artigo fornece exemplos de código que limpam e excluem intervalos com a API JavaScript do Excel. Para obter a lista completa de propriedades e métodos compatíveis com o Range objeto, consulte 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.

Limpar um intervalo de células

O exemplo de código a seguir limpa todo o conteúdo e a formatação das células no intervalo 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();
});

Dados antes da limpeza do intervalo

Dados no Excel antes que o intervalo seja limpo.

Dados após a limpeza do intervalo

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

Excluir um intervalo de células

O exemplo de código a seguir exclui as células no intervalo B4:E4 e desloca outras células para preencher o espaço que foi desocupado pelas células excluídas.

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

Dados antes da exclusão do intervalo

Os dados no Excel antes do intervalo são excluídos.

Dados após a exclusão do intervalo

Os dados no Excel após o intervalo são excluídos.

Confira também