Compartilhar via

Obter um intervalo com a API JavaScript do Excel

Este artigo fornece exemplos que mostram diferentes formas de obter um intervalo numa folha de cálculo com a API JavaScript do Excel. Para obter a lista completa de propriedades e métodos suportados pelo Range objeto, consulte Excel.Range class (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.

Obter intervalo por endereço

O seguinte exemplo de código obtém o intervalo com o endereço B2:C5 da folha de cálculo com o nome Exemplo, carrega a respetiva address propriedade e escreve uma mensagem na consola do .

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    
    let range = sheet.getRange("B2:C5");
    range.load("address");
    await context.sync();
    
    console.log(`The address of the range B2:C5 is "${range.address}"`);
});

Obter intervalo por nome

O seguinte exemplo de código obtém o intervalo com o nome MyRange da folha de cálculo denominada Exemplo, carrega a respetiva address propriedade e escreve uma mensagem na consola do .

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getRange("MyRange");
    range.load("address");
    await context.sync();

    console.log(`The address of the range "MyRange" is "${range.address}"`);
});

Obter intervalo usado

O seguinte exemplo de código obtém o intervalo utilizado a partir da folha de cálculo denominada Exemplo, carrega a respetiva address propriedade e escreve uma mensagem na consola do . O intervalo usado é o menor intervalo que abrange todas as células na planilha que têm um valor ou uma formatação atribuída a elas. Se toda a folha de cálculo estiver em branco, o getUsedRange() método devolve um intervalo que consiste apenas na célula superior esquerda.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getUsedRange();
    range.load("address");
    await context.sync();
    
    console.log(`The address of the used range in the worksheet is "${range.address}"`);
});

Obter intervalo inteiro

O exemplo de código seguinte obtém todo o intervalo da folha de cálculo a partir da folha de cálculo denominada Exemplo, carrega a respetiva address propriedade e escreve uma mensagem na consola do .

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getRange();
    range.load("address");
    await context.sync();
    
    console.log(`The address of the entire worksheet range is "${range.address}"`);
});

Confira também

  • Last updated on