Diese Seite wurde von der Cloud Translation API übersetzt.

Class RangeList

Eine Sammlung mit einer oder mehreren Range-Instanzen im selben Tabellenblatt. Sie können diese Klasse verwenden, um Vorgänge auf Sammlungen von nicht nebeneinanderliegenden Bereichen 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 in der Bereichsliste wieder in einzelne Zellen auf.
`check()`	`RangeList`	Ändert den Status der Kästchen im Bereich in „aktiviert“.
`clear()`	`RangeList`	Löscht den Bereich der Inhalte, Formate und Datenvalidierungsregeln für jede `Range` in der Bereichsliste.
`clear(options)`	`RangeList`	Löscht den Inhalt, das Format, die Datenvalidierungsregeln und die Kommentare, wie mit den angegebenen Optionen angegeben.
`clearContent()`	`RangeList`	Löscht den Inhalt der einzelnen `Range` in der Bereichsliste, wobei die Formatierung beibehalten wird.
`clearDataValidations()`	`RangeList`	Löscht die Datenvalidierungsregeln für jede `Range` in der Bereichsliste.
`clearFormat()`	`RangeList`	Löscht die Textformatierung für jeden `Range` in der Bereichsliste.
`clearNote()`	`RangeList`	Löscht die Notiz für jeden `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 des Bereichs ein Kästchen ein, das mit `true` für aktiviert und `false` für deaktivierte Zellen konfiguriert ist.
`insertCheckboxes(checkedValue)`	`RangeList`	Fügt in jede Zelle des Bereichs ein Kästchen ein, das mit einem benutzerdefinierten Wert für aktiviert und dem leeren String für deaktivierte Zellen konfiguriert ist.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	In jede Zelle des Bereichs werden Kästchen eingefügt, die mit benutzerdefinierten Werten für aktivierte und deaktivierte Status konfiguriert sind.
`removeCheckboxes()`	`RangeList`	Entfernt alle Kästchen aus dem Bereich.
`setBackground(color)`	`RangeList`	Legt die Hintergrundfarbe für jeden `Range` in der Bereichsliste fest.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Legt als Hintergrund die angegebene RGB-Farbe fest.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Legt die Rahmeneigenschaft für jeden `Range` in der Bereichsliste fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Legt die Rahmeneigenschaft mit der Farbe und/oder dem Stil für jeden `Range` in der Bereichsliste fest.
`setFontColor(color)`	`RangeList`	Legt die Schriftfarbe für jeden `Range` in der Bereichsliste fest.
`setFontFamily(fontFamily)`	`RangeList`	Legt die Schriftfamilie für jeden `Range` in der Bereichsliste fest.
`setFontLine(fontLine)`	`RangeList`	Hiermit wird der Stil der Schriftlinie für jeden `Range` in der Bereichsliste festgelegt.
`setFontSize(size)`	`RangeList`	Hiermit wird die Schriftgröße (in Punkten) für jeden `Range` in der Bereichsliste festgelegt.
`setFontStyle(fontStyle)`	`RangeList`	Legen Sie den Schriftstil für jeden `Range` in der Bereichsliste fest.
`setFontWeight(fontWeight)`	`RangeList`	Legen Sie die Schriftstärke für jeden `Range` in der Bereichsliste fest.
`setFormula(formula)`	`RangeList`	Aktualisiert die Formel für jeden `Range` in der Bereichsliste.
`setFormulaR1C1(formula)`	`RangeList`	Aktualisiert die Formel für jeden `Range` in der Bereichsliste.
`setHorizontalAlignment(alignment)`	`RangeList`	Legen Sie die horizontale Ausrichtung für jeden `Range` in der Bereichsliste fest.
`setNote(note)`	`RangeList`	Legt den Notiztext für jeden `Range` in der Bereichsliste fest.
`setNumberFormat(numberFormat)`	`RangeList`	Legt die Zahl oder das Datumsformat für jeden `Range` in der Bereichsliste fest.
`setShowHyperlink(showHyperlink)`	`RangeList`	Legt fest, ob für jede `Range` in der Bereichsliste Hyperlinks angezeigt werden sollen.
`setTextDirection(direction)`	`RangeList`	Legt die Textrichtung für die Zellen in den einzelnen `Range` in der Bereichsliste fest.
`setTextRotation(degrees)`	`RangeList`	Legt die Textrotationseinstellungen für die Zellen in jedem `Range` in der Bereichsliste fest.
`setValue(value)`	`RangeList`	Legt den Wert für jeden `Range` in der Bereichsliste fest.
`setVerticalAlignment(alignment)`	`RangeList`	Legen Sie die vertikale Ausrichtung für jeden `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 den Textumbruch für jede `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 jeder Zelle in dieser Bereichsliste an.
`uncheck()`	`RangeList`	Der Status der Kästchen im Bereich wird in „Deaktiviert“ 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: Auf diese Weise können Sie mehrere Bereiche gleichzeitig 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();

Return

RangeList: Die Liste der aktiven Bereiche für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`breakApart()`

Teilen Sie alle horizontal oder vertikal verbundenen Zellen in der Bereichsliste wieder in einzelne Zellen auf.

Der Aufruf dieser Funktion für eine Bereichsliste entspricht dem Auswählen eines Satzes von Bereichen und dem Auswählen des Menüpunkts Format > Zusammenführen > Zusammenführung aufheben.

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`check()`

Ändert den Status der Kästchen im Bereich in „Aktiviert“. Die Zellen im Bereich, die derzeit weder den konfigurierten als auch den ungeprüften 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clear()`

Löscht den Bereich der Inhalte, Formate und Datenvalidierungsregeln für jede Range in der Bereichsliste.

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clear(options)`

Löscht den Inhalt, das Format, die Datenvalidierungsregeln und die Kommentare, wie mit den angegebenen Optionen angegeben. 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 das Löschen gefilterter Zeilen vermieden werden soll.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clearContent()`

Löscht den Inhalt der einzelnen Range in der Bereichsliste, wobei die Formatierung beibehalten wird.

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clearFormat()`

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

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

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clearNote()`

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

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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.

Return

Range[]: Die Liste der Bereiche.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`insertCheckboxes()`

Fügt in jede Zelle des Bereichs ein Kästchen ein, das mit true für aktiviert und false für deaktivierte Zellen 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();

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`insertCheckboxes(checkedValue)`

Fügt in jede Zelle des Bereichs ein Kästchen ein, das mit einem benutzerdefinierten Wert für aktiviert und dem leeren String für deaktivierte Zellen konfiguriert ist. 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 aktivierte Wert für die Kästchendatenvalidierung.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

In jede Zelle des Bereichs werden Kästchen eingefügt, die mit benutzerdefinierten Werten für aktivierte und deaktivierte Status konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den benutzerdefinierten, deaktivierten 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 aktivierte Wert für die Kästchendatenvalidierung.
`uncheckedValue`	`Object`	Der deaktivierte Wert für die Kästchendatenvalidierung.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 den aktivierten oder nicht deaktivierten 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();

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setBackground(color)`

Legt die Hintergrundfarbe für jeden 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'`. Ein `null`-Wert setzt die Farbe zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setBackgroundRGB(red, green, blue)`

Legt als Hintergrund die angegebene RGB-Farbe fest. Dies 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`	Roter Wert in RGB-Notation.
`green`	`Integer`	Grüner Wert in RGB-Notation.
`blue`	`Integer`	Blauer Wert in RGB-Notation.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 jeden Range in der Bereichsliste fest. Die gültigen Werte sind true (on), false (off) 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 keine, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keine, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keine, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keine, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für vertikale Rahmenlinien, `false` für keine, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale Rahmenlinien, `false` für keine, `null` für keine Änderung.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

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

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFontColor(color)`

Legt die Schriftfarbe für jeden 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.setFontColor('red');

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Schriftfarbe in CSS-Notation wie `'#ffffff'` oder `'white'`. Ein `null`-Wert setzt die Farbe zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFontFamily(fontFamily)`

Legt die Schriftfamilie für jeden Range in der Bereichsliste fest. Die Schriftfamilie wird durch eine String-ID 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 Schriftfamilie, die festgelegt werden soll. Der Wert `null` setzt die Schriftfamilie zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFontLine(fontLine)`

Hiermit wird der Stil der Schriftlinie für jeden Range in der Bereichsliste festgelegt. Die Optionen für Linienarten 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 Stil der Schriftlinie, entweder `'underline'`, `'line-through'` oder `'none'`. Der Wert `null` setzt den Stil der Schriftlinie zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFontSize(size)`

Hiermit wird die Schriftgröße (in Punkten) für jeden Range in der Bereichsliste festgelegt.

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

Parameter

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFontStyle(fontStyle)`

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

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

Parameter

Name	Typ	Beschreibung
`fontStyle`	`String`	Die Schriftart, entweder `'italic'` oder `'normal'`. Der Wert `null` setzt die Schriftart zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFontWeight(fontWeight)`

Legen Sie die Schriftstärke für jeden 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'`. Ein Wert von `null` setzt die Schriftstärke zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFormula(formula)`

Aktualisiert die Formel für jeden Range in der Bereichsliste. Die Formel muss in A1-Notation angegeben werden.

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.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setFormulaR1C1(formula)`

Aktualisiert die Formel für jeden 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.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setHorizontalAlignment(alignment)`

Legen Sie die horizontale Ausrichtung für jeden 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'`. Ein `null`-Wert setzt die Ausrichtung zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setNote(note)`

Legt den Notiztext für jeden 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 Notiztext; mit dem Wert `null` wird die Notiz entfernt.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setNumberFormat(numberFormat)`

Legt die Zahl oder das Datumsformat für jeden Range in der Bereichsliste fest.

Die zulässigen Formatierungsmuster sind im Leitfaden zur Datums- und Zahlenformatierung in 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 String im Zahlenformat.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setShowHyperlink(showHyperlink)`

Legt fest, ob für jede Range in der Bereichsliste Hyperlinks angezeigt werden 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 wird.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setTextDirection(direction)`

Legt die Textrichtung für die Zellen in den einzelnen 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.
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 der Festlegung abgeleitet.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setTextRotation(degrees)`

Legt die Textrotationseinstellungen für die Zellen in jedem Range in der Bereichsliste fest. Die Eingabe entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Der Wert null bedeutet, dass für den Text die Standardausrichtung verwendet wird.

Für die Textrichtung von links nach rechts folgen positive Winkel gegen den Uhrzeigersinn, während sie für die Textrichtung von rechts nach rechts im Uhrzeigersinn liegen.

// 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 folgen positive Winkel gegen den Uhrzeigersinn.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setValue(value)`

Legt den Wert für jeden 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.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setVerticalAlignment(alignment)`

Legen Sie die vertikale Ausrichtung für jeden 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'`. Ein `null`-Wert setzt die Ausrichtung zurück.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setWrap(isWrapEnabled)`

Legen Sie den Textumbruch für jede Range in der Bereichsliste fest. Bei Zellen mit aktiviertem Zeilenumbruch wird die Größe so angepasst, dass der gesamte Inhalt angezeigt wird. Zellen, für die die Zeilenumbruchfunktion deaktiviert ist, werden so oft wie möglich in der Zelle angezeigt, ohne dass ihre Größe angepasst wird oder sie nicht über mehrere Zeilen laufen.

// 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 Text umgebrochen wird oder nicht.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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.

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 jeder Zelle in dieser Bereichsliste an. Entfernt sämtliche Leerzeichen am Anfang und Ende des Textes jeder Zelle und reduziert alle Untersequenzen verbleibender Leerzeichen auf 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)']

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 aktiviert“. Die Zellen im Bereich, die derzeit weder den konfigurierten als auch den deaktivierten 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 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Return

RangeList: Diese Bereichsliste für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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