Class RangeList

Eine Sammlung von einer oder mehreren Range-Instanzen im selben Tabellenblatt. Mit dieser Klasse können Sie Vorgänge auf Sammlungen von nicht angrenzenden Bereichen 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`	Ändert den Status der Kästchen im Bereich in „checked“.
`clear()`	`RangeList`	Löscht den Bereich mit Inhalten, Formaten und Regeln zur Datenvalidierung für jedes `Range` in der Bereichsliste.
`clear(options)`	`RangeList`	Löscht den Bereich mit Inhalten, Format, Datenvalidierungsregeln und Kommentaren, wie mit den angegebenen Optionen festgelegt.
`clearContent()`	`RangeList`	Löscht den Inhalt jedes `Range` in der Bereichsliste, wobei die Formatierung erhalten bleibt.
`clearDataValidations()`	`RangeList`	Löscht die Datenvalidierungsregeln für jedes `Range` in der Bereichsliste.
`clearFormat()`	`RangeList`	Entfernt die Textformatierung für jedes `Range` in der Bereichsliste.
`clearNote()`	`RangeList`	Entfernt 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`	Fügt in jede Zelle im Bereich Kästchen ein, die mit `true` für markiert und `false` für nicht markiert konfiguriert sind.
`insertCheckboxes(checkedValue)`	`RangeList`	Fügt in jede Zelle im Bereich Kontrollkästchen ein, die mit einem benutzerdefinierten Wert für „checked“ und dem leeren String für „unchecked“ konfiguriert sind.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten und nicht ausgewählten Zustände konfiguriert sind.
`removeCheckboxes()`	`RangeList`	Entfernt alle Kästchen aus dem Bereich.
`setBackground(color)`	`RangeList`	Legt die Hintergrundfarbe für jedes `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 Rahmen-Property für jedes `Range` in der Bereichsliste fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Legt die Rahmenlinieneigenschaft mit Farbe und/oder Stil für jedes `Range` in der Bereichsliste fest.
`setFontColor(color)`	`RangeList`	Legt die Schriftfarbe für jedes `Range` in der Bereichsliste fest.
`setFontFamily(fontFamily)`	`RangeList`	Legt die Schriftfamilie für jedes `Range` in der Bereichsliste fest.
`setFontLine(fontLine)`	`RangeList`	Legt den Schriftlinienstil für jedes `Range` in der Bereichsliste fest.
`setFontSize(size)`	`RangeList`	Legt die Schriftgröße (in Punkten) für jedes `Range` in der Bereichsliste fest.
`setFontStyle(fontStyle)`	`RangeList`	Legen Sie den Schriftstil für jedes `Range` in der Bereichsliste fest.
`setFontWeight(fontWeight)`	`RangeList`	Legen Sie die Schriftstärke für jedes `Range` in der Bereichsliste fest.
`setFormula(formula)`	`RangeList`	Aktualisiert die Formel für jedes `Range` in der Bereichsliste.
`setFormulaR1C1(formula)`	`RangeList`	Aktualisiert die Formel für jedes `Range` in der Bereichsliste.
`setHorizontalAlignment(alignment)`	`RangeList`	Legen Sie die horizontale Ausrichtung für jede `Range` in der Bereichsliste fest.
`setNote(note)`	`RangeList`	Legt den Anmerkungstext für jedes `Range` in der Bereichsliste fest.
`setNumberFormat(numberFormat)`	`RangeList`	Legt das Zahlen- oder Datumsformat für jedes `Range` in der Bereichsliste fest.
`setShowHyperlink(showHyperlink)`	`RangeList`	Legt fest, ob für die einzelnen `Range` in der Bereichsliste Hyperlinks angezeigt werden sollen.
`setTextDirection(direction)`	`RangeList`	Legt die Textrichtung für die Zellen in jedem `Range` in der Bereichsliste fest.
`setTextRotation(degrees)`	`RangeList`	Legt die Einstellungen für die Textrotation für die Zellen in jedem `Range` in der Bereichsliste fest.
`setValue(value)`	`RangeList`	Legt den Wert für jedes `Range` in der Bereichsliste fest.
`setVerticalAlignment(alignment)`	`RangeList`	Legen Sie die vertikale Ausrichtung für jedes `Range` in der Bereichsliste fest.
`setVerticalText(isVertical)`	`RangeList`	Legt fest, ob der Text für die Zellen für jedes `Range` in der Bereichsliste gestapelt werden soll.
`setWrap(isWrapEnabled)`	`RangeList`	Legen Sie den Zeilenumbruch für jede `Range` in der Bereichsliste fest.
`setWrapStrategy(strategy)`	`RangeList`	Legt die Strategie für den Zeilenumbruch für jedes `Range` in der Bereichsliste fest.
`trimWhitespace()`	`RangeList`	Entfernt die Leerräume (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle in dieser Bereichsliste.
`uncheck()`	`RangeList`	Ändert den Status der Kästchen im Bereich in „nicht angekreuzt“.

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 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: Die Liste der aktiven Bereiche für die 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

`breakApart()`

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

Wenn Sie diese Funktion für eine Bereichsliste aufrufen, entspricht das der Auswahl einer Reihe von Bereichen und der Auswahl des Google Sheets-Menüpunkts Format > Zusammenführen > Aufheben.

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()`

Ändert den Status der Kästchen im Bereich in „checked“. Zellen im Bereich, die derzeit weder den konfigurierten Wert für „checked“ noch für „unchecked“ 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 Bereich mit Inhalten, Formaten und Regeln zur Datenvalidierung für jedes Range in der Bereichsliste.

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 Bereich mit Inhalten, Format, Datenvalidierungsregeln und Kommentaren, wie mit den angegebenen Optionen festgelegt. 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 erweiterte Parameter wie unten aufgeführt angibt.

Erweiterte Parameter

Name	Typ	Beschreibung
`commentsOnly`	`Boolean`	Gibt an, ob nur die Kommentare gelöscht werden sollen.
`contentsOnly`	`Boolean`	Gibt an, ob nur der Inhalt gelöscht werden soll.
`formatOnly`	`Boolean`	Gibt an, ob nur das Format gelöscht werden soll. Wenn Sie das Format löschen, werden auch die Datenvalidierungsregeln gelöscht.
`validationsOnly`	`Boolean`	Gibt an, ob nur Datenvalidierungsregeln gelöscht werden sollen.
`skipFilteredRows`	`Boolean`	Gibt an, 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()`

Löscht den Inhalt jedes Range in der Bereichsliste, wobei die Formatierung erhalten bleibt.

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()`

Löscht die Datenvalidierungsregeln für jedes Range in der Bereichsliste.

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()`

Entfernt die Textformatierung für jedes Range in der Bereichsliste.

Dadurch wird die Textformatierung für jeden Bereich entfernt, aber es werden keine Regeln für die Zahlenformatierung 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()`

Entfernt 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()`

Fügt in jede Zelle im Bereich Kästchen ein, die mit true für markiert und false für nicht markiert 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)`

Fügt in jede Zelle im Bereich Kontrollkästchen ein, die mit einem benutzerdefinierten Wert für „checked“ und dem leeren String für „unchecked“ konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den leeren String fest.

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 Wert, der für die Datenvalidierung des Kästchens festgelegt ist, wenn das Kästchen aktiviert ist.

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)`

Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten und nicht ausgewählten Zustände konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den benutzerdefinierten Wert für nicht angekreuzte Kästchen fest.

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 Wert, der für die Datenvalidierung des Kästchens festgelegt ist, wenn das Kästchen aktiviert ist.
`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. Entfernt die Datenvalidierung für jede Zelle und löscht zusätzlich den Wert, wenn die Zelle den Wert für „Aktiviert“ oder „Deaktiviert“ enthält.

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 jedes 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 ein Convenience-Wrapper 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üne Wert 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 Rahmen-Property für jedes 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 und `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen und `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen und `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen und `null` für keine Änderung.
`vertical`	`Boolean`	`true` für interne vertikale Rahmen, `false` für keine und `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für interne horizontale Rahmen, `false` für keine und `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)`

Legt die Rahmenlinieneigenschaft mit Farbe und/oder Stil für jedes Range in der Bereichsliste fest. Gültige Werte sind true (an), false (aus) und null (keine Änderung). Die Farbe wird in CSS-Notation dargestellt, 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 und `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen und `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen und `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen und `null` für keine Änderung.
`vertical`	`Boolean`	`true` für interne vertikale Rahmen, `false` für keine und `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für interne horizontale Rahmen, `false` für keine und `null` für keine Änderung.
`color`	`String`	Die Rahmenfarbe in CSS-Notation, z. B. `'#ffffff'` oder `'white'`, `null` für die Standardfarbe (Schwarz).
`style`	`BorderStyle`	Der Stil für die Rahmen. `null` für den Standardstil (durchgezogen).

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 jedes 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.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)`

Legt die Schriftfamilie für jedes Range in der Bereichsliste fest. Die Schriftfamilie wird durch einen String-Identifier 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 festzulegende Schriftfamilie. Mit dem Wert `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)`

Legt den Schriftlinienstil für jedes Range in der Bereichsliste fest. Die Optionen für 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 Linienstil der Schriftart, entweder `'underline'`, `'line-through'` oder `'none'`. Mit dem Wert `null` wird der Linienstil der 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

`setFontSize(size)`

Legt die Schriftgröße (in Punkten) für jedes 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 jedes 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`	Der Schriftstil, entweder `'italic'` oder `'normal'`. Mit dem Wert `null` wird der Schriftstil 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 die Schriftstärke für jedes Range in der Bereichsliste 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)`

Aktualisiert die Formel für jedes Range in der Bereichsliste. 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 festzulegende 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)`

Aktualisiert die Formel für jedes Range in der Bereichsliste. Die angegebene Formel muss in der 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 Ausrichtungsoptionen 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'`. Ein `null`-Wert setzt die Ausrichtung 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

`setNote(note)`

Legt den Anmerkungstext für jedes 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 festzulegende Notiztext. 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)`

Legt das Zahlen- oder Datumsformat für jedes Range in der Bereichsliste fest.

Die zulässigen Formatierungsmuster sind im Leitfaden zur Datums- und Zahlenformatierung für die 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 Zahlenformatstring.

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)`

Legt fest, ob für die einzelnen 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 jedem Range in der Bereichsliste fest. Wenn die 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`, wird die Richtung vor dem Festlegen 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)`

Legt die Einstellungen für die Textrotation für die Zellen in jedem Range in der Bereichsliste fest. Die Eingabe entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Bei einer Eingabe von null wird der Text in der Standardausrichtung angezeigt.

Bei einer Textrichtung von links nach rechts werden positive Winkel gegen den Uhrzeigersinn gemessen, bei einer Textrichtung von rechts nach links 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 rechtsläufigem Text werden positive Winkel gegen den Uhrzeigersinn gemessen.

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 jedes Range in der Bereichsliste fest. Der Wert kann numerisch, ein String, ein boolescher Wert oder ein Datum sein. Wenn es mit „=“ beginnt, wird es 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 jedes 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'`. Ein `null`-Wert setzt die Ausrichtung 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

`setVerticalText(isVertical)`

Legt fest, ob der Text für die Zellen für jedes Range in der Bereichsliste gestapelt werden soll. Wenn der Text vertikal gestapelt ist, wird die Einstellung für die Textrotation 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`	Gibt an, 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 den Zeilenumbruch für jede Range in der Bereichsliste fest. Zellen mit aktiviertem Zeilenumbruch werden so angepasst, dass ihr gesamter Inhalt angezeigt wird. In Zellen, in denen der Zeilenumbruch deaktiviert ist, wird so viel wie möglich in der Zelle angezeigt, ohne dass die Größe angepasst oder mehrere Zeilen verwendet werden.

// 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`	Gibt an, ob Text umgebrochen 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

`setWrapStrategy(strategy)`

Legt die Strategie für den Zeilenumbruch für jedes Range in der Bereichsliste fest.

// 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()`

Entfernt die Leerräume (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle in dieser Bereichsliste. Entfernt alle Leerzeichen am Anfang und Ende des Texts jeder Zelle und reduziert alle nachfolgenden Leerzeichen 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()`

Ändert den Status der Kästchen im Bereich in „nicht ausgewählt“. Zellen im Bereich, die derzeit weder den konfigurierten Wert für „ausgewählt“ noch den für „nicht ausgewählt“ 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

`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()`