Diese Seite wurde von der Cloud Translation API übersetzt.

Class RangeList
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Eine Sammlung von einer oder mehreren Range-Instanzen auf demselben Tabellenblatt. Mit dieser Klasse können Sie Vorgänge auf Sammlungen nicht zusammenhängender Bereiche oder Zellen anwenden.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`activate()`	`RangeList`	Wählt die Liste der `Range`-Instanzen aus.
`breakApart()`	`RangeList`	Alle horizontal oder vertikal zusammengeführten Zellen in der Bereichsliste werden wieder in einzelne Zellen aufgeteilt.
`check()`	`RangeList`	Der Status der Kästchen im Bereich wird in „angeklickt“ geändert.
`clear()`	`RangeList`	Löscht den Inhalt, die Formate und die Regeln für die Datenvalidierung für jeden `Range` in der Bereichsliste.
`clear(options)`	`RangeList`	Löscht den Inhaltsbereich, das Format, die Datenvalidierungsregeln und die Kommentare, die mit den entsprechenden Optionen angegeben wurden.
`clearContent()`	`RangeList`	Der Inhalt aller `Range` in der Bereichsliste wird gelöscht, die Formatierung bleibt jedoch erhalten.
`clearDataValidations()`	`RangeList`	Die Datenvalidierungsregeln für alle `Range` in der Bereichsliste werden gelöscht.
`clearFormat()`	`RangeList`	Die Textformatierung für jede `Range` in der Bereichsliste wird gelöscht.
`clearNote()`	`RangeList`	Löscht die Notiz für jede `Range` in der Bereichsliste.
`getRanges()`	`Range[]`	Gibt eine Liste mit einer oder mehreren `Range`-Instanzen im selben Tabellenblatt zurück.
`insertCheckboxes()`	`RangeList`	Es werden Kästchen in jede Zelle im Bereich eingefügt, die mit `true` für angeklickt und `false` für nicht angeklickt konfiguriert sind.
`insertCheckboxes(checkedValue)`	`RangeList`	Setzt in jede Zelle im Bereich Kästchen ein, die mit einem benutzerdefinierten Wert für „Ausgewählt“ und dem leeren String für „Nicht ausgewählt“ konfiguriert sind.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Es werden Kästchen in jede Zelle des Bereichs eingefügt, die mit benutzerdefinierten Werten für den ausgewählten und den nicht ausgewählten Status konfiguriert sind.
`removeCheckboxes()`	`RangeList`	Entfernt alle Kästchen aus dem Bereich.
`setBackground(color)`	`RangeList`	Legt die Hintergrundfarbe für jede `Range` in der Bereichsliste fest.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Legt den Hintergrund auf die angegebene RGB-Farbe fest.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Legt die Rahmeneigenschaft für jede `Range` in der Bereichsliste fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Hiermit wird die Rahmeneigenschaft mit Farbe und/oder Stil für jede `Range` in der Bereichsliste festgelegt.
`setFontColor(color)`	`RangeList`	Legt die Schriftfarbe für jede `Range` in der Bereichsliste fest.
`setFontFamily(fontFamily)`	`RangeList`	Hiermit wird die Schriftfamilie für jede `Range` in der Bereichsliste festgelegt.
`setFontLine(fontLine)`	`RangeList`	Hiermit wird der Schriftstil für jede `Range` in der Bereichsliste festgelegt.
`setFontSize(size)`	`RangeList`	Legt die Schriftgröße (in Punkten) für jede `Range` in der Bereichsliste fest.
`setFontStyle(fontStyle)`	`RangeList`	Legen Sie den Schriftstil für jede `Range` in der Bereichsliste fest.
`setFontWeight(fontWeight)`	`RangeList`	Legen Sie für jede `Range` in der Bereichsliste die Schriftstärke fest.
`setFormula(formula)`	`RangeList`	Die Formel für jede `Range` in der Bereichsliste wird aktualisiert.
`setFormulaR1C1(formula)`	`RangeList`	Die Formel für jede `Range` in der Bereichsliste wird aktualisiert.
`setHorizontalAlignment(alignment)`	`RangeList`	Legen Sie die horizontale Ausrichtung für jede `Range` in der Bereichsliste fest.
`setNote(note)`	`RangeList`	Legt den Notizentext für jede `Range` in der Bereichsliste fest.
`setNumberFormat(numberFormat)`	`RangeList`	Hiermit wird das Zahlen- oder Datumsformat für jede `Range` in der Bereichsliste festgelegt.
`setShowHyperlink(showHyperlink)`	`RangeList`	Hiermit wird festgelegt, ob für jede `Range` in der Bereichsliste Hyperlinks angezeigt werden sollen.
`setTextDirection(direction)`	`RangeList`	Legt die Textrichtung für die Zellen in jeder `Range` in der Bereichsliste fest.
`setTextRotation(degrees)`	`RangeList`	Hier legen Sie die Einstellungen für die Textdrehung für die Zellen in den einzelnen `Range` in der Bereichsliste fest.
`setValue(value)`	`RangeList`	Legt den Wert für jede `Range` in der Bereichsliste fest.
`setVerticalAlignment(alignment)`	`RangeList`	Legen Sie die vertikale Ausrichtung für jede `Range` in der Bereichsliste fest.
`setVerticalText(isVertical)`	`RangeList`	Legt fest, ob der Text für die Zellen für jede `Range` in der Bereichsliste gestapelt werden soll.
`setWrap(isWrapEnabled)`	`RangeList`	Legen Sie für jede `Range` in der Bereichsliste den Textumbruch fest.
`setWrapStrategy(strategy)`	`RangeList`	Hiermit wird die Textumbruchstrategie für jede `Range` in der Bereichsliste festgelegt.
`trimWhitespace()`	`RangeList`	Hiermit werden die Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle dieser Bereichsliste entfernt.
`uncheck()`	`RangeList`	Der Status der Kästchen im Bereich wird zu „Deaktiviert“ geändert.

Detaillierte Dokumentation

`activate()`

Wählt die Liste der Range-Instanzen aus. Der letzte Bereich in der Liste wird als active range festgelegt.

Hinweis:So können Sie mehrere Bereiche gleichzeitig auswählen.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

Rückflug

RangeList: Liste der aktiven Bereiche für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`breakApart()`

Alle horizontal oder vertikal zusammengeführten Zellen in der Bereichsliste werden wieder in einzelne Zellen aufgeteilt.

Wenn Sie diese Funktion auf eine Bereichsliste anwenden, entspricht das dem Auswählen mehrerer Bereiche und dem Ausführen des Menüpunkts Format > Zusammenführen > Zusammenführen aufheben in Google Tabellen.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`check()`

Der Status der Kästchen im Bereich wird in „angeklickt“ geändert. Zellen im Bereich, die derzeit weder den konfigurierten angeklickten noch den konfigurierten nicht angeklickten Wert enthalten, werden ignoriert.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'checked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear()`

Löscht den Inhalt, die Formate und die Datenvalidierungsregeln für jeden Bereich in der Bereichsliste.Range

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear(options)`

Löscht den Inhaltsbereich, das Format, die Datenvalidierungsregeln und die Kommentare, die mit den entsprechenden Optionen angegeben wurden. Standardmäßig werden alle Daten gelöscht.

// The code below clears the contents of the following ranges A:A and C:C in the
// active sheet, but preserves the format, data validation rules, and comments.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parameter

Name	Typ	Beschreibung
`options`	`Object`	Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt.

Erweiterte Parameter

Name	Typ	Beschreibung
`commentsOnly`	`Boolean`	Ob nur die Kommentare gelöscht werden sollen.
`contentsOnly`	`Boolean`	Ob nur der Inhalt gelöscht werden soll.
`formatOnly`	`Boolean`	Ob nur das Format gelöscht werden soll. Hinweis: Wenn Sie das Format löschen, werden auch Datenvalidierungsregeln gelöscht.
`validationsOnly`	`Boolean`	Ob nur Datenvalidierungsregeln gelöscht werden sollen.
`skipFilteredRows`	`Boolean`	Ob gefilterte Zeilen nicht gelöscht werden sollen.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearContent()`

Der Inhalt aller Range in der Bereichsliste wird gelöscht, die Formatierung bleibt jedoch erhalten.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearDataValidations()`

Die Datenvalidierungsregeln für alle Range in der Bereichsliste werden gelöscht.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearFormat()`

Die Textformatierung für jede Range in der Bereichsliste wird gelöscht.

Dadurch wird die Textformatierung für jeden Bereich gelöscht, aber keine Zahlenformatierungsregeln zurückgesetzt.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearNote()`

Löscht die Notiz für jede Range in der Bereichsliste.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRanges()`

Gibt eine Liste mit einer oder mehreren Range-Instanzen im selben Tabellenblatt zurück.

Rückflug

Range[] – Die Liste der Bereiche.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCheckboxes()`

Es werden Kästchen in jede Zelle im Bereich eingefügt, die mit true für angeklickt und false für nicht angeklickt konfiguriert sind. Legt den Wert aller Zellen im Bereich auf false fest.

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'true' for checked and 'false' for unchecked. Also, sets the value of each
// cell in the ranges D4 and E6 to 'false'.
rangeList.insertCheckboxes();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCheckboxes(checkedValue)`

Setzt in jede Zelle im Bereich Kästchen ein, die mit einem benutzerdefinierten Wert für „Ausgewählt“ und dem leeren String für „Nicht ausgewählt“ konfiguriert sind. Der Wert jeder Zelle im Bereich wird auf den leeren String festgelegt.

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and the empty string for unchecked. Also, sets the value of
// each cell in the ranges D4 and E6 to the empty string.
rangeList.insertCheckboxes('yes');

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der angeklickte Wert für die Validierung von Kästchendaten.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCheckboxes(checkedValue, uncheckedValue)`

Es werden Kästchen in jede Zelle des Bereichs eingefügt, die mit benutzerdefinierten Werten für den angeklickten und den nicht angeklickten Status konfiguriert sind. Der Wert jeder Zelle im Bereich wird auf den benutzerdefinierten Wert gesetzt, der nicht angeklickt wurde.

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and 'no' for unchecked. Also, sets the value of each cell
// in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der angeklickte Wert für die Kästchendatenvalidierung.
`uncheckedValue`	`Object`	Der Wert für das Kästchen ohne Häkchen bei der Datenvalidierung.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeCheckboxes()`

Entfernt alle Kästchen aus dem Bereich. Die Datenvalidierung für jede Zelle wird gelöscht. Wenn die Zelle den angeklickten oder nicht angeklickten Wert enthält, wird auch dieser gelöscht.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their
// value.
rangeList1.removeCheckboxes();

const rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear
// their value.
rangeList2.removeCheckboxes();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackground(color)`

Legt die Hintergrundfarbe für jede Range in der Bereichsliste fest. Die Farbe wird in CSS-Notation dargestellt, z. B. '#ffffff' oder 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

Parameter

Name	Typ	Beschreibung
`color`	`String`	Der Hintergrundfarbcode in CSS-Notation, z. B. `'#ffffff'` oder `'white'`. Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgroundRGB(red, green, blue)`

Legt den Hintergrund auf die angegebene RGB-Farbe fest. Dies ist eine praktische Ummantelung für einen setBackground(color)-Aufruf.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

Parameter

Name	Typ	Beschreibung
`red`	`Integer`	Der Rotwert in RGB-Schreibweise.
`green`	`Integer`	Der Grünwert in RGB-Schreibweise.
`blue`	`Integer`	Der Blauwert in RGB-Schreibweise.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBorder(top, left, bottom, right, vertical, horizontal)`

Legt die Rahmeneigenschaft für jede Range in der Bereichsliste fest. Gültige Werte sind true (an), false (aus) und null (keine Änderung).

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves
// the left and right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

Parameter

Name	Typ	Beschreibung
`top`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für vertikale Innenränder, `false` für keine Ränder, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale interne Rahmen, `false` für keine, `null` für keine Änderung.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Hiermit wird die Rahmeneigenschaft mit Farbe und/oder Stil für jede Range in der Bereichsliste festgelegt. Gültige Werte sind true (an), false (aus) und null (keine Änderung). Die Farbe wird in CSS-Notation angegeben, z. B. '#ffffff' oder 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged
// of the ranges A2:B4 and C1:D4. Also sets the color to 'red', and the border
// to 'DASHED'.
rangeList.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

Parameter

Name	Typ	Beschreibung
`top`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für vertikale Innenränder, `false` für keine Ränder, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale interne Rahmen, `false` für keine, `null` für keine Änderung.
`color`	`String`	Die Rahmenfarbe in CSS-Notation wie `'#ffffff'` oder `'white'`, `null` für die Standardfarbe (Schwarz).
`style`	`BorderStyle`	Der Stil für die Rahmen, `null` für den Standardstil (durchgehend).

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColor(color)`

Legt die Schriftfarbe für jede Range in der Bereichsliste fest. Die Farbe wird in CSS-Notation angegeben, z. B. '#ffffff' oder 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Schriftfarbe in CSS-Notation, z. B. `'#ffffff'` oder `'white'`. Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontFamily(fontFamily)`

Hiermit wird die Schriftfamilie für jede Range in der Bereichsliste festgelegt. Die Schriftfamilie wird durch eine String-ID wie Arial oder Roboto beschrieben.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

Parameter

Name	Typ	Beschreibung
`fontFamily`	`String`	Die Schriftfamilie, die festgelegt werden soll. Bei einem Wert von `null` wird die Schriftfamilie zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontLine(fontLine)`

Hiermit wird der Schriftstil für jede Range in der Bereichsliste festgelegt. Die Optionen für die Linienarten sind 'underline', 'line-through' oder 'none'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

Parameter

Name	Typ	Beschreibung
`fontLine`	`String`	Der Schriftschnitt, entweder `'underline'`, `'line-through'` oder `'none'`. Der Wert `null` setzt den Schriftschnitt zurück.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontSize(size)`

Legt die Schriftgröße (in Punkten) für jede Range in der Bereichsliste fest.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

Parameter

Name	Typ	Beschreibung
`size`	`Integer`	Eine Schriftgröße in Punkt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontStyle(fontStyle)`

Legen Sie den Schriftstil für jede Range in der Bereichsliste fest. Die Optionen für den Schriftstil sind 'italic' oder 'normal'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle('italic');

Parameter

Name	Typ	Beschreibung
`fontStyle`	`String`	Die Schriftart, entweder `'italic'` oder `'normal'`. Mit dem Wert `null` wird die Schriftart zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontWeight(fontWeight)`

Legen Sie für jede Range in der Bereichsliste die Schriftstärke fest. Die Optionen für die Schriftstärke sind 'normal' oder 'bold'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

Parameter

Name	Typ	Beschreibung
`fontWeight`	`String`	Die Schriftstärke, entweder `'bold'` oder `'normal'`. Mit dem Wert `null` wird die Schriftstärke zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormula(formula)`

Die Formel für jede Range in der Bereichsliste wird aktualisiert. Die angegebene Formel muss in A1-Notation sein.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Ein String, der die zu setzende Formel darstellt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormulaR1C1(formula)`

Die Formel für jede Range in der Bereichsliste wird aktualisiert. Die angegebene Formel muss in R1C1-Notation sein.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Eine Stringformel.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHorizontalAlignment(alignment)`

Legen Sie die horizontale Ausrichtung für jede Range in der Bereichsliste fest. Die Optionen für die Ausrichtung sind 'left', 'center' oder 'right'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment('center');

Parameter

Name	Typ	Beschreibung
`alignment`	`String`	Die Ausrichtung, entweder `'left'`, `'center'` oder `'normal'`. Mit dem Wert `null` wird die Ausrichtung zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNote(note)`

Legt den Notizentext für jede Range in der Bereichsliste fest.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

Parameter

Name	Typ	Beschreibung
`note`	`String`	Der zu setzende Notizentext. Wenn Sie den Wert auf `null` setzen, wird die Notiz entfernt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNumberFormat(numberFormat)`

Hiermit wird das Zahlen- oder Datumsformat für jede Range in der Bereichsliste festgelegt.

Die zulässigen Formatierungsmuster sind im Leitfaden zur Datums- und Zahlenformatierung in der Sheets API beschrieben.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Parameter

Name	Typ	Beschreibung
`numberFormat`	`String`	Ein String für das Zahlenformat.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setShowHyperlink(showHyperlink)`

Hiermit wird festgelegt, ob für jede Range in der Bereichsliste Hyperlinks angezeigt werden sollen.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

Parameter

Name	Typ	Beschreibung
`showHyperlink`	`Boolean`	Gibt an, ob der Hyperlink angezeigt werden soll.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextDirection(direction)`

Legt die Textrichtung für die Zellen in jeder Range in der Bereichsliste fest. Wenn eine angegebene Richtung null ist, wird die Richtung abgeleitet und dann festgelegt.

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parameter

Name	Typ	Beschreibung
`direction`	`TextDirection`	Die gewünschte Textrichtung. Wenn `null` angegeben ist, wird die Richtung vor der Einstellung abgeleitet.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotation(degrees)`

Hier legen Sie die Einstellungen für die Textdrehung für die Zellen in den einzelnen Range in der Bereichsliste fest. Der eingegebene Wert entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Ein Wert von null gibt an, dass der Text in der Standardausrichtung ist.

Bei einer linksläufigen Textrichtung sind positive Winkel gegen den Uhrzeigersinn, bei einer rechtsläufigen Textrichtung im Uhrzeigersinn.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

Parameter

Name	Typ	Beschreibung
`degrees`	`Integer`	Der gewünschte Winkel zwischen der Standardausrichtung und der gewünschten Ausrichtung. Bei linksläufigem Text sind positive Winkel gegen den Uhrzeigersinn.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setValue(value)`

Legt den Wert für jede Range in der Bereichsliste fest. Der Wert kann numerisch, ein String, ein boolescher Wert oder ein Datum sein. Wenn der String mit „=“ beginnt, wird er als Formel interpretiert.

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

Parameter

Name	Typ	Beschreibung
`value`	`Object`	Der Wert für den Bereich.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setVerticalAlignment(alignment)`

Legen Sie die vertikale Ausrichtung für jede Range in der Bereichsliste fest. Die Ausrichtungsoptionen sind 'top', 'middle' oder 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

Parameter

Name	Typ	Beschreibung
`alignment`	`String`	Die Ausrichtung, entweder `'top'`, `'middle'` oder `'bottom'`. Mit dem Wert `null` wird die Ausrichtung zurückgesetzt.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setVerticalText(isVertical)`

Legt fest, ob der Text für die Zellen für jede Range in der Bereichsliste gestapelt werden soll. Wenn der Text vertikal gestapelt ist, wird die Einstellung für die Textdrehung in Grad ignoriert.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

Parameter

Name	Typ	Beschreibung
`isVertical`	`Boolean`	Ob der Text gestapelt werden soll.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrap(isWrapEnabled)`

Legen Sie für jede Range in der Bereichsliste den Textumbruch fest. Zellen mit aktiviertem Umbruch werden so skaliert, dass ihr gesamter Inhalt angezeigt wird. In Zellen, bei denen das Umbrechen deaktiviert ist, wird der Inhalt so weit wie möglich dargestellt, ohne dass die Zellengröße geändert oder der Inhalt auf mehrere Zeilen verteilt werden muss.

// Enable text wrap for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

Parameter

Name	Typ	Beschreibung
`isWrapEnabled`	`Boolean`	Ob der Text umgebrochen werden soll oder nicht.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrapStrategy(strategy)`

Hiermit wird die Textumbruchstrategie für jede Range in der Bereichsliste festgelegt.

// Sets the list of ranges to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parameter

Name	Typ	Beschreibung
`strategy`	`WrapStrategy`	Die gewünschte Umbruchstrategie.

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`trimWhitespace()`

Hiermit werden die Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle dieser Bereichsliste entfernt. Entfernt alle Leerzeichen am Anfang und Ende des Texts in jeder Zelle und reduziert alle verbleibenden Leerzeichenfolgen auf ein einzelnes Leerzeichen.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Weitere Informationen

Range.trimWhitespace()

`uncheck()`

Der Status der Kästchen im Bereich wird in „Deaktiviert“ geändert. Zellen im Bereich, die derzeit weder den konfigurierten Wert „Angeklickt“ noch „Deaktiviert“ enthalten, werden ignoriert.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'unchecked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Rückflug

RangeList – Diese Bereichsliste zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Class RangeList Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Methoden

Detaillierte Dokumentation

activate()

Rückflug

Autorisierung

breakApart()

Rückflug

Autorisierung

check()

Rückflug

Autorisierung

clear()

Rückflug

Autorisierung

clear(options)

Parameter

Erweiterte Parameter

Rückflug

Autorisierung

clearContent()

Rückflug

Autorisierung

clearDataValidations()

Rückflug

Autorisierung

clearFormat()

Rückflug

Autorisierung

clearNote()

Rückflug

Autorisierung

getRanges()

Rückflug

Autorisierung

insertCheckboxes()

Rückflug

Autorisierung

insertCheckboxes(checkedValue)

Parameter

Rückflug

Autorisierung

insertCheckboxes(checkedValue, uncheckedValue)

Parameter

Rückflug

Autorisierung

removeCheckboxes()

Rückflug

Autorisierung

setBackground(color)

Parameter

Rückflug

Autorisierung

setBackgroundRGB(red, green, blue)

Parameter

Rückflug

Autorisierung

setBorder(top, left, bottom, right, vertical, horizontal)

Parameter

Rückflug

Autorisierung

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Parameter

Rückflug

Autorisierung

setFontColor(color)

Parameter

Rückflug

Autorisierung

setFontFamily(fontFamily)

Parameter

Rückflug

Autorisierung

setFontLine(fontLine)

Parameter

Rückflug

Autorisierung

setFontSize(size)

Parameter

Rückflug

Class RangeList
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

`activate()`

`breakApart()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`getRanges()`

`insertCheckboxes()`

`insertCheckboxes(checkedValue)`

`insertCheckboxes(checkedValue, uncheckedValue)`

`removeCheckboxes()`

`setBackground(color)`

`setBackgroundRGB(red, green, blue)`

`setBorder(top, left, bottom, right, vertical, horizontal)`

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

`setFontColor(color)`

`setFontFamily(fontFamily)`

`setFontLine(fontLine)`

`setFontSize(size)`

`setFontStyle(fontStyle)`

`setFontWeight(fontWeight)`

`setFormula(formula)`

`setFormulaR1C1(formula)`

`setHorizontalAlignment(alignment)`

`setNote(note)`

`setNumberFormat(numberFormat)`

`setShowHyperlink(showHyperlink)`

`setTextDirection(direction)`

`setTextRotation(degrees)`

`setValue(value)`

`setVerticalAlignment(alignment)`

`setVerticalText(isVertical)`

`setWrap(isWrapEnabled)`

`setWrapStrategy(strategy)`

`trimWhitespace()`

`uncheck()`