ExcelScript.WorkbookRangeAreas interface

  • Referenz
Paket:
ExcelScript

Stellt eine Auflistung von einem oder mehreren rechteckigen Bereichen in mehreren Arbeitsblättern dar.

Hinweise

Beispiele

/**
 * 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);
  });
}

Methoden

getAddresses()

Gibt ein Array von Adressen im A1-Stil zurück. Adresswerte enthalten den Namen des Arbeitsblatts für jeden rechteckigen Zellblock (z. B. "Sheet1! A1:B4, Sheet1! D1:D4"). Schreibgeschützt.
getAreas()

Gibt das RangeAreasCollection -Objekt zurück. Jede RangeAreas in der Auflistung stellt einen oder mehrere Rechteckbereiche in einem Arbeitsblatt dar.
getRangeAreasBySheet(key)

Gibt das Objekt basierend auf dem Namen oder der RangeAreas ID des Arbeitsblatts in der Auflistung zurück. Wenn das Arbeitsblatt nicht vorhanden ist, gibt diese Methode zurück undefined.
getRanges()

Gibt Bereiche zurück, aus denen dieses Objekt in einem -Objekt besteht RangeCollection .

Details zur Methode

getAddresses()

Gibt ein Array von Adressen im A1-Stil zurück. Adresswerte enthalten den Namen des Arbeitsblatts für jeden rechteckigen Zellblock (z. B. "Sheet1! A1:B4, Sheet1! D1:D4"). Schreibgeschützt.

getAddresses(): string[];

Gibt zurück

string[]

getAreas()

Gibt das RangeAreasCollection -Objekt zurück. Jede RangeAreas in der Auflistung stellt einen oder mehrere Rechteckbereiche in einem Arbeitsblatt dar.

getAreas(): RangeAreas[];

Gibt zurück

ExcelScript.RangeAreas[]

getRangeAreasBySheet(key)

Gibt das Objekt basierend auf dem Namen oder der RangeAreas ID des Arbeitsblatts in der Auflistung zurück. Wenn das Arbeitsblatt nicht vorhanden ist, gibt diese Methode zurück undefined.

getRangeAreasBySheet(key: string): RangeAreas;

Parameter

key

string

Der Name oder die ID des Arbeitsblatts.

Gibt zurück

ExcelScript.RangeAreas

getRanges()

Gibt Bereiche zurück, aus denen dieses Objekt in einem -Objekt besteht RangeCollection .

getRanges(): Range[];

Gibt zurück

ExcelScript.Range[]