Partager via

ExcelScript.WorkbookRangeAreas interface

Colis:
ExcelScript

Représente une collection d’une ou plusieurs plages rectangulaires dans plusieurs feuilles de calcul.

Remarques

Exemples

/**
 * 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éthode

getAddresses()

Retourne un tableau d’adresses de style A1. Les valeurs d’adresse contiennent le nom de feuille de calcul pour chaque bloc rectangulaire de cellules (par exemple, « Feuille1 ! A1 :B4, Feuille1 ! D1 :D4"). En lecture seule.
getAreas()

Retourne l’objet RangeAreasCollection . Chaque RangeAreas dans la collection représente une ou plusieurs plages de rectangles dans une feuille de calcul.
getRangeAreasBySheet(key)

Retourne l’objet RangeAreas en fonction du nom ou de l’ID de feuille de calcul dans la collection. Si la feuille de calcul n’existe pas, cette méthode retourne undefined.
getRanges()

Retourne des plages qui composent cet objet dans un RangeCollection objet .

Détails de la méthode

getAddresses()

Retourne un tableau d’adresses de style A1. Les valeurs d’adresse contiennent le nom de feuille de calcul pour chaque bloc rectangulaire de cellules (par exemple, « Feuille1 ! A1 :B4, Feuille1 ! D1 :D4"). En lecture seule.

getAddresses(): string[];

Retourne

string[]

getAreas()

Retourne l’objet RangeAreasCollection . Chaque RangeAreas dans la collection représente une ou plusieurs plages de rectangles dans une feuille de calcul.

getAreas(): RangeAreas[];

Retourne

ExcelScript.RangeAreas[]

getRangeAreasBySheet(key)

Retourne l’objet RangeAreas en fonction du nom ou de l’ID de feuille de calcul dans la collection. Si la feuille de calcul n’existe pas, cette méthode retourne undefined.

getRangeAreasBySheet(key: string): RangeAreas;

Paramètres

key

string

Nom ou ID de la feuille de calcul.

Retourne

ExcelScript.RangeAreas

getRanges()

Retourne des plages qui composent cet objet dans un RangeCollection objet .

getRanges(): Range[];

Retourne

ExcelScript.Range[]