Diese Seite wurde von der Cloud Translation API übersetzt.

Class RangeList

Eine Sammlung von einer oder mehreren Range-Instanzen im selben Tabellenblatt. Sie können diese Klasse verwenden, um Vorgänge auf Sammlungen nicht benachbarter Bereiche oder Zellen anzuwenden.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`activate()`	`RangeList`	Wählt die Liste der `Range`-Instanzen aus.
`breakApart()`	`RangeList`	Teilen Sie alle horizontal oder vertikal verbundenen Zellen, die in der Bereichsliste enthalten sind, noch einmal in einzelne Zellen auf.
`check()`	`RangeList`	Ändert den Status der Kästchen im Bereich in „Angeklickt“.
`clear()`	`RangeList`	Löscht den Inhalt, die Formate und die Datenvalidierungsregeln für jede `Range` in der Bereichsliste.
`clear(options)`	`RangeList`	Löscht den Inhalt, das Format, die Datenvalidierungsregeln und Kommentare gemäß den angegebenen Optionen.
`clearContent()`	`RangeList`	Löscht den Inhalt jedes `Range` in der Bereichsliste und die Formatierung bleibt unverändert.
`clearDataValidations()`	`RangeList`	Löscht die Datenvalidierungsregeln für jede `Range` in der Bereichsliste.
`clearFormat()`	`RangeList`	Löscht die Textformatierung für jedes `Range` in der Bereichsliste.
`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`	Fügt Kästchen in jede Zelle im Bereich ein, die mit `true` für aktiviert und `false` ohne Häkchen konfiguriert ist.
`insertCheckboxes(checkedValue)`	`RangeList`	Fügt Kästchen in jede Zelle im Bereich ein, die mit einem benutzerdefinierten Wert für Häkchen und einem leeren String für Häkchen deaktiviert sind.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Fügt Kästchen in jede Zelle im Bereich ein, die mit benutzerdefinierten Werten für die aktivierten und ungeprüften Status konfiguriert sind.
`removeCheckboxes()`	`RangeList`	Entfernt alle Kästchen aus dem Bereich.
`setBackground(color)`	`RangeList`	Legt die Hintergrundfarbe für die einzelnen `Range` in der Bereichsliste fest.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Als Hintergrund wird die angegebene RGB-Farbe festgelegt.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Legt die Rand-Property für jede `Range` in der Bereichsliste fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Legt die Rand-Property für jede `Range` in der Bereichsliste mit Farbe und/oder Stil fest.
`setFontColor(color)`	`RangeList`	Legt die Schriftfarbe für jede `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 jede `Range` in der Bereichsliste fest.
`setFontSize(size)`	`RangeList`	Legt die Schriftgröße (in Punkten) für jeden `Range` in der Bereichsliste fest.
`setFontStyle(fontStyle)`	`RangeList`	Die Schriftstilart für jede `Range` in der Bereichsliste.
`setFontWeight(fontWeight)`	`RangeList`	Legen Sie die Schriftstärke für jede `Range` in der Bereichsliste fest.
`setFormula(formula)`	`RangeList`	Aktualisiert die Formel für jede `Range` in der Bereichsliste.
`setFormulaR1C1(formula)`	`RangeList`	Aktualisiert die Formel für jede `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 Notizentext für jede `Range` in der Bereichsliste fest.
`setNumberFormat(numberFormat)`	`RangeList`	Legt das Zahlen- oder Datumsformat für jede `Range` in der Bereichsliste fest.
`setShowHyperlink(showHyperlink)`	`RangeList`	Legt fest, ob die einzelnen `Range` in der Bereichsliste Hyperlinks enthalten 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 Textdrehung für die Zellen in jeder `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 jede `Range` in der Bereichsliste gestapelt wird.
`setWrap(isWrapEnabled)`	`RangeList`	Legen Sie den Zeilenumbruch für jedes `Range` in der Bereichsliste fest.
`setWrapStrategy(strategy)`	`RangeList`	Legt die Textumbruchstrategie für jede `Range` in der Bereichsliste fest.
`trimWhitespace()`	`RangeList`	Passt die Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jede Zelle dieser Bereichsliste an.
`uncheck()`	`RangeList`	Der Status der Kästchen im Bereich wird zu „Nicht angeklickt“ geändert.

Detaillierte Dokumentation

`activate()`

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

Hinweis:So lassen sich mehrere Bereiche mehrfach auswählen.

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

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

Zurücksenden

RangeList: Liste der aktiven Bereiche für Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`breakApart()`

Teilen Sie alle horizontal oder vertikal verbundenen Zellen, die in der Bereichsliste enthalten sind, noch einmal in einzelne Zellen auf.

Der Aufruf dieser Funktion für eine Bereichsliste entspricht dem Auswählen einer Reihe von Bereichen und dem Auswählen des Menüpunkts Format > Zusammenführen von Tabellenblättern aufheben.

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`check()`

Ändert den Status der Kästchen im Bereich in "Angeklickt". Ignoriert die Zellen im Bereich, die derzeit weder den konfigurierten noch den ungeprüften Wert enthalten.

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 jede Range in der Bereichsliste.

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`clear(options)`

Löscht den Inhalt, das Format, die Datenvalidierungsregeln und Kommentare gemäß den angegebenen Optionen. 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parameter

Name	Typ	Beschreibung
`options`	`Object`	Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

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. Beim Löschen des Formats werden auch die Datenvalidierungsregeln gelöscht.
`validationsOnly`	`Boolean`	Gibt an, ob nur Datenvalidierungsregeln gelöscht werden sollen.
`skipFilteredRows`	`Boolean`	Gibt an, ob gefilterte Zeilen gelöscht werden sollen.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`clearContent()`

Löscht den Inhalt jedes Range in der Bereichsliste und die Formatierung bleibt unverändert.

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`clearDataValidations()`

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

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`clearFormat()`

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

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

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

Zurücksenden

Range[]: Die Liste der Bereiche.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`insertCheckboxes()`

Fügt Kästchen in jede Zelle im Bereich ein, die mit true für aktiviert und false ohne Häkchen konfiguriert ist. Legt den Wert aller Zellen im Bereich auf false fest.

var 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();

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`insertCheckboxes(checkedValue)`

Fügt Kästchen in jede Zelle im Bereich ein, die mit einem benutzerdefinierten Wert für Häkchen und einem leeren String für Häkchen deaktiviert sind. Legt den Wert jeder Zelle im Bereich auf den leeren String fest.

var 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 geprüfte Wert für die Validierung der Kästchendaten.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Fügt Kästchen in jede Zelle im Bereich ein, die mit benutzerdefinierten Werten für die aktivierten und ungeprüften Status konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den benutzerdefinierten, ungeprüften Wert fest.

var 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 geprüfte Wert für die Validierung der Kästchendaten.
`uncheckedValue`	`Object`	Der Wert ohne Häkchen für die Validierung der Kästchendaten.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`removeCheckboxes()`

Entfernt alle Kästchen aus dem Bereich. Löscht die Datenvalidierung jeder Zelle und löscht zusätzlich ihren Wert, wenn die Zelle entweder den aktivierten oder nicht ausgewählten Wert enthält.

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

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

var 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();

var 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();

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setBackground(color)`

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

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

Parameter

Name	Typ	Beschreibung
`color`	`String`	Der Hintergrundfarbencode in CSS-Notation wie `'#ffffff'` oder `'white'`; mit einem `null`-Wert wird die Farbe zurückgesetzt.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setBackgroundRGB(red, green, blue)`

Als Hintergrund wird die angegebene RGB-Farbe festgelegt. Das ist ein Convenience-Wrapper um einen setBackground(color)-Aufruf.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 rote Wert in RGB-Notation
`green`	`Integer`	Der grüne Wert in RGB-Notation.
`blue`	`Integer`	Der blaue Wert in RGB-Notation

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

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

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für innere vertikale Rahmenlinien, `false` für keine, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für interne horizontale Rahmenlinien, `false` für keine, `null` für keine Änderung.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

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

Legt die Rand-Property für jede Range in der Bereichsliste mit Farbe und/oder Stil fest. Gültige Werte sind true (ein), false (aus) und null (keine Änderung). Die Farbe wird in der CSS-Notation dargestellt, z. B. '#ffffff' oder 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für innere vertikale Rahmenlinien, `false` für keine, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für interne horizontale Rahmenlinien, `false` für keine, `null` für keine Änderung.
`color`	`String`	Die Rahmenfarbe in CSS-Notation wie `'#ffffff'` oder `'white'`, `null` für Standardfarbe (schwarz).
`style`	`BorderStyle`	Der Stil der Rahmen, `null` für den Standardstil (konsolidiert).

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 der CSS-Notation dargestellt, z. B. '#ffffff' oder 'white'.

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

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Schriftfarbe in CSS-Notation wie `'#ffffff'` oder `'white'`; mit einem `null`-Wert wird die Farbe zurückgesetzt.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 eine Stringkennung wie Arial oder Roboto beschrieben.

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

Parameter

Name	Typ	Beschreibung
`fontFamily`	`String`	Die festzulegende Schriftfamilie; ein Wert von `null` setzt die Schriftfamilie zurück.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setFontLine(fontLine)`

Legt den Schriftlinienstil für jede Range in der Bereichsliste fest. Die Optionen für Linienstile sind 'underline', 'line-through' oder 'none'.

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

Parameter

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setFontSize(size)`

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

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

Parameter

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setFontStyle(fontStyle)`

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

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

Parameter

Name	Typ	Beschreibung
`fontStyle`	`String`	Der Schriftstil, entweder `'italic'` oder `'normal'`, wird durch einen `null`-Wert zurückgesetzt.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setFontWeight(fontWeight)`

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

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

Parameter

Name	Typ	Beschreibung
`fontWeight`	`String`	Die Schriftstärke, entweder `'bold'` oder `'normal'`; der Wert `null` setzt die Schriftgröße zurück.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setFormula(formula)`

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

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

Parameter

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setFormulaR1C1(formula)`

Aktualisiert die Formel für jede Range in der Bereichsliste. Die angegebene Formel muss in R1C1-Notation angegeben werden.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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'.

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

Parameter

Name	Typ	Beschreibung
`alignment`	`String`	Die Ausrichtung, entweder `'left'`, `'center'` oder `'normal'`, wird durch einen `null`-Wert zurückgesetzt.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

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

Parameter

Name	Typ	Beschreibung
`note`	`String`	Der festzulegende Text. Mit einem Wert von `null` wird die Notiz entfernt.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setNumberFormat(numberFormat)`

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

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setShowHyperlink(showHyperlink)`

Legt fest, ob die einzelnen Range in der Bereichsliste Hyperlinks enthalten sollen.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 eine angegebene Richtung null ist, wird die Richtung abgeleitet und dann festgelegt.

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setTextRotation(degrees)`

Legt die Einstellungen für die Textdrehung für die Zellen in jeder Range in der Bereichsliste fest. Die Eingabe entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Eine Eingabe von null gibt an, dass für den Text die Standardausrichtung festgelegt ist.

Bei Textrichtung von links nach rechts sind positive Winkel im Uhrzeigersinn entgegengesetzt, während sie von rechts nach links im Uhrzeigersinn ausgerichtet werden.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var 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 Text von links nach rechts befinden sich positive Winkel in entgegengesetzter Richtung.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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, String, boolescher Wert oder Datum sein. Wenn sie mit '=' beginnt, wird sie als Formel interpretiert.

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

Parameter

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

Parameter

Name	Typ	Beschreibung
`alignment`	`String`	Die Ausrichtung, entweder `'top'`, `'middle'` oder `'bottom'`, wird durch einen `null`-Wert zurückgesetzt.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 wird. Wenn der Text vertikal gestapelt ist, wird die Einstellung für die Gradangabe für die Textrotation ignoriert.

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

Parameter

Name	Typ	Beschreibung
`isVertical`	`Boolean`	Gibt an, ob der Text gestapelt werden soll.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setWrap(isWrapEnabled)`

Legen Sie den Zeilenumbruch für jedes Range in der Bereichsliste fest. Bei Zellen mit aktivierter Wrapping-Größe wird der gesamte Inhalt angezeigt. Zellen mit umschlossenem Zeilenumbruch werden in der Zelle so weit wie möglich angezeigt, ohne die Größe anzupassen oder sie auf mehrere Zeilen anzuwenden.

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

Parameter

Name	Typ	Beschreibung
`isWrapEnabled`	`Boolean`	Gibt an, ob der Text umgebrochen werden soll.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setWrapStrategy(strategy)`

Legt die Textumbruchstrategie für jede Range in der Bereichsliste fest.

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

Parameter

Name	Typ	Beschreibung
`strategy`	`WrapStrategy`	Die gewünschte Wrapping-Strategie.

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`trimWhitespace()`

Passt die Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jede Zelle dieser Bereichsliste an. Entfernt sämtliche Leerzeichen am Anfang und Ende des Texts in jeder Zelle und reduziert die Teilfolge der verbleibenden Leerzeichen in ein einzelnes Leerzeichen.

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

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

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 angeklickt". Ignoriert die Zellen im Bereich, die derzeit weder den konfigurierten noch den ungeprüften Wert enthalten.

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

Zurücksenden

RangeList: Diese Bereichsliste zur Verkettung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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