ExcelScript.WorkbookRangeAreas interface

Pacote:

ExcelScript

Representa uma coleção de um ou mais intervalos retangulares em várias folhas de cálculo.

Comentários

Exemplos

/**
 * This script finds the direct precedents of the active cell.
 * It changes the font and color of those precedent cells. 
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the active cell.
  const selected = workbook.getActiveCell();
  
  // Get the cells that are direct precedents of the current cell.
  const precedents : ExcelScript.WorkbookRangeAreas = selected.getDirectPrecedents();

  // Set the font to bold and the fill color to orange for all the precedent cells.
  precedents.getRanges().forEach(range => {
    range.getFormat().getFill().setColor("orange");
    range.getFormat().getFont().setBold(true);
  });
}

Métodos

getAddresses()	Devolve uma matriz de endereços no estilo A1. Os valores de endereço contêm o nome da folha de cálculo para cada bloco retangular de células (por exemplo, "Folha1! A1:B4, Folha1! D1:D4"). Somente leitura.
getAreas()	Devolve o RangeAreasCollection objeto . Cada RangeAreas um na coleção representa um ou mais intervalos de retângulos numa folha de cálculo.
getRangeAreasBySheet(key)	Devolve o RangeAreas objeto com base no nome ou ID da folha de cálculo na coleção. Se a folha de cálculo não existir, este método devolve undefined.
getRanges()	Devolve intervalos que compõem este objeto num RangeCollection objeto.

Detalhes do método

getAddresses()

Devolve uma matriz de endereços no estilo A1. Os valores de endereço contêm o nome da folha de cálculo para cada bloco retangular de células (por exemplo, "Folha1! A1:B4, Folha1! D1:D4"). Somente leitura.

getAddresses(): string[];

Retornos

string[]

getAreas()

Devolve o RangeAreasCollection objeto . Cada RangeAreas um na coleção representa um ou mais intervalos de retângulos numa folha de cálculo.

getAreas(): RangeAreas[];

Retornos

ExcelScript.RangeAreas[]

getRangeAreasBySheet(key)

Devolve o RangeAreas objeto com base no nome ou ID da folha de cálculo na coleção. Se a folha de cálculo não existir, este método devolve undefined.

getRangeAreasBySheet(key: string): RangeAreas;

Parâmetros

key

string

O nome ou ID da folha de cálculo.

Retornos

ExcelScript.RangeAreas

getRanges()

Devolve intervalos que compõem este objeto num RangeCollection objeto.

getRanges(): Range[];

Retornos

ExcelScript.Range[]