Diese Seite wurde von der Cloud Translation API übersetzt.

Class RangeList

Eine Sammlung von einer oder mehreren Range-Instanzen in demselben Tabellenblatt. Sie können diesen Kurs verwenden um Operationen auf Sammlungen nicht nebeneinanderliegender Bereiche oder Zellen anzuwenden.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`activate()`	`RangeList`	Wählt die Liste der `Range`-Instanzen aus.
`breakApart()`	`RangeList`	Alle horizontal oder vertikal verbundenen Zellen in der Bereichsliste aufbrechen: einzelne Zellen wieder ein.
`check()`	`RangeList`	Ändert den Status der Kästchen im Bereich zu „aktiviert“.
`clear()`	`RangeList`	Löscht den Inhaltsbereich, die Formate und die Datenvalidierungsregeln für jede `Range` in Bereichsliste.
`clear(options)`	`RangeList`	Löscht den Inhalt, das Format, die Datenvalidierungsregeln und die Kommentare, wie mit die verfügbaren Optionen.
`clearContent()`	`RangeList`	Löscht den Inhalt aller `Range` in der Bereichsliste, wobei die Formatierung beibehalten wird.
`clearDataValidations()`	`RangeList`	Löscht die Datenvalidierungsregeln für jeden `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 Kästchen in jede Zelle im Bereich ein, die mit `true` für aktivierte und `false` für nicht aktiviert.
`insertCheckboxes(checkedValue)`	`RangeList`	Fügt in jede Zelle im Bereich Kästchen ein, die mit einem benutzerdefinierten Wert für aktivierte und der leere Zeichenfolge für deaktiviert.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten Zellen konfiguriert sind. und ungeprüfte Zustände.
`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 die angegebene RGB-Farbe als Hintergrund fest.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Legt die Eigenschaft "Rahmen" für jeden `Range` in der Bereichsliste fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Legt die Rahmeneigenschaft mit Farbe und/oder Stil für jedes `Range` in der Bereichsliste fest.
`setFontColor(color)`	`RangeList`	Legt die Schriftfarbe für jeden `Range` in der Bereichsliste fest.
`setFontFamily(fontFamily)`	`RangeList`	Hiermit wird die Schriftfamilie für jede `Range` in der Bereichsliste festgelegt.
`setFontLine(fontLine)`	`RangeList`	Hiermit wird der Linienstil der Schriftart für jeden `Range` in der Bereichsliste festgelegt.
`setFontSize(size)`	`RangeList`	Hiermit wird die Schriftgröße (in Punkten) für jede `Range` in der Bereichsliste festgelegt.
`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 jede `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 für jeden `Range` in der Bereichsliste die horizontale Ausrichtung fest.
`setNote(note)`	`RangeList`	Legt den Notiztext für jede `Range` in der Bereichsliste fest.
`setNumberFormat(numberFormat)`	`RangeList`	Legt das Zahlen- oder Datumsformat für jeden `Range` in der Bereichsliste fest.
`setShowHyperlink(showHyperlink)`	`RangeList`	Legt fest, ob jedes `Range` in der Bereichsliste Hyperlinks enthalten soll.
`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 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 jeden `Range` im Bereich gestapelt werden soll Liste.
`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 den Leerraum (z. B. Leerzeichen, Tabulatoren oder neue Zeilen) in allen Zellen in dieser Bereichsliste an.
`uncheck()`	`RangeList`	Ändert den Status der Kästchen im Bereich zu „Deaktiviert“

Detaillierte Dokumentation

`activate()`

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

Hinweis:Dadurch können mehrere Bereiche gleichzeitig ausgewählt werden.

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

Rückflug

RangeList: Die Liste der aktiven Bereiche 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

`breakApart()`

Alle horizontal oder vertikal verbundenen Zellen in der Bereichsliste aufbrechen: einzelne Zellen wieder ein.

Der Aufruf dieser Funktion für eine Bereichsliste entspricht der Auswahl eines Satzes von Bereichen und im Bereich Format > Zusammenführen > Menüpunkt „Verbindung aufheben“ für Google Tabellen.

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`check()`

Ändert den Status der Kästchen im Bereich zu „aktiviert“. Die Zellen im Bereich werden ignoriert. die derzeit weder den aktivierten noch den deaktivierten 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();

Rückflug

RangeList: Diese Bereichsliste zur 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

`clear()`

Löscht den Inhaltsbereich, die Formate und die Datenvalidierungsregeln für jede Range in Bereichsliste.

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`clear(options)`

Löscht den Inhalt, das Format, die Datenvalidierungsregeln und die Kommentare, wie mit die verfügbaren 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; dass das Löschen Datenvalidierungsregeln lö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

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 aller Range in der Bereichsliste, wobei die Formatierung beibehalten wird.

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`clearDataValidations()`

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

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`clearFormat()`

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

Dadurch wird die Textformatierung für die einzelnen Bereiche gelöscht, die Regeln für die Zahlenformatierung werden jedoch nicht zurückgesetzt.

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

Rückflug

RangeList: Diese Bereichsliste zur 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

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`getRanges()`

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

Rückflug

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 Kästchen in jede Zelle im Bereich ein, die mit true für aktivierte und false für nicht aktiviert. 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();

Rückflug

RangeList: Diese Bereichsliste zur 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

`insertCheckboxes(checkedValue)`

Fügt in jede Zelle im Bereich Kästchen ein, die mit einem benutzerdefinierten Wert für aktivierte und der leere Zeichenfolge für deaktiviert. Legt den Wert jeder Zelle im Bereich als 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 Datenvalidierung des Kästchens.

Rückflug

RangeList: Diese Bereichsliste zur 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

`insertCheckboxes(checkedValue, uncheckedValue)`

Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten Zellen konfiguriert sind. und ungeprüfte Zustände. Legt für den Wert jeder Zelle im Bereich 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 geprüfte Wert für die Datenvalidierung des Kästchens.
`uncheckedValue`	`Object`	Der deaktivierte Wert für die Datenvalidierung des Kästchens.

Rückflug

RangeList: Diese Bereichsliste zur 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

`removeCheckboxes()`

Entfernt alle Kästchen aus dem Bereich. Löscht die Datenvalidierung jeder Zelle und Außerdem wird der Wert gelöscht, falls die Zelle entweder den aktivierten oder den 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();

Rückflug

RangeList: Diese Bereichsliste zur 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

`setBackground(color)`

Legt die Hintergrundfarbe für jeden Range in der Bereichsliste fest. Farbe wird dargestellt in in der CSS-Notation; 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`	den Hintergrundfarbencode in CSS-Notation wie `'#ffffff'` oder `'white'` wird der Wert `null` die Farbe zurückgesetzt.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setBackgroundRGB(red, green, blue)`

Setzt den Hintergrund auf die angegebene RGB-Farbe. Dies ist ein praktischer 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 Rotwert in RGB-Notation.
`green`	`Integer`	Der grüne Wert in RGB-Notation.
`blue`	`Integer`	Der Blauwert in RGB-Notation.

Rückflug

RangeList: Diese Bereichsliste zur 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

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

Legt die Eigenschaft "Rahmen" für jede Range in der Bereichsliste fest. Gültige Werte: true (an), 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 vertikale innere Rahmen, `false` für keinen und `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale innere Rahmen, `false` für keinen und `null` für keine Änderung.

Rückflug

RangeList: Diese Bereichsliste zur 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

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

Legt die Rahmeneigenschaft mit Farbe und/oder Stil für jedes Range in der Bereichsliste fest. Gültige Werte sind true (on), false (off) und null (keine Änderung). Farbe ist in CSS-Notation dargestellt werden. 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 vertikale innere Rahmen, `false` für keinen und `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale innere Rahmen, `false` für keinen 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 (durchgehend).

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFontColor(color)`

Legt die Schriftfarbe für jeden Range in der Bereichsliste fest. Farbe wird in CSS dargestellt. Notation; 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'` eine Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFontFamily(fontFamily)`

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

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 wird die Schriftfamilie bei `null` zurückgesetzt.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFontLine(fontLine)`

Hiermit wird der Linienstil der Schriftart für jeden Range in der Bereichsliste festgelegt. Optionen für Linienstile 'underline', 'line-through' oder 'none' sind.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'`; wird der Wert für `null` die Linienart der Schriftart zurückgesetzt.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFontSize(size)`

Hiermit wird die Schriftgröße (in Punkten) für jede 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.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFontStyle(fontStyle)`

Legen Sie den Schriftstil für jedes Range in der Bereichsliste fest. 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'`. `null` wird die Schriftart zurückgesetzt.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFontWeight(fontWeight)`

Legen Sie die Schriftstärke für jede Range in der Bereichsliste fest. Die Optionen für die Schriftstärke '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'`. `null` setzt die Schriftstärke zurück.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFormula(formula)`

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

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.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setFormulaR1C1(formula)`

Aktualisiert die Formel für jeden Range in der Bereichsliste. Die angegebene Formel muss R1C1-Schreibweise.

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`setHorizontalAlignment(alignment)`

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

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'`. eine Der Wert `null` setzt die Ausrichtung zurück.

Rückflug

RangeList: Diese Bereichsliste zur 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

`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 Notizentext, der festgelegt werden soll: wird der Wert `null` entfernt.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setNumberFormat(numberFormat)`

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

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`setShowHyperlink(showHyperlink)`

Legt fest, ob jedes Range in der Bereichsliste Hyperlinks enthalten soll.

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.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setTextDirection(direction)`

Legt die Textrichtung für die Zellen in jedem Range in der Bereichsliste fest. Wenn ein 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 Bei `null` wird die Richtung vor dem Ableiten der Richtung abgeleitet. Einstellung.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setTextRotation(degrees)`

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

Bei Textrichtung von links nach rechts verlaufen positive Winkel gegen den Uhrzeigersinn. während sie bei rechts nach links 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 verlaufen positive Winkel gegen den Uhrzeigersinn.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setValue(value)`

Legt den Wert für jeden Range in der Bereichsliste fest. Der Wert kann numerisch, Zeichenfolge, ein Boolescher Wert oder ein Datum. Wenn sie mit '=' beginnt wird es 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.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setVerticalAlignment(alignment)`

Legen Sie die vertikale Ausrichtung für jeden Range in der Bereichsliste fest. 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'`. eine Der Wert `null` setzt die Ausrichtung zurück.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setVerticalText(isVertical)`

Legt fest, ob der Text für die Zellen für jeden Range im Bereich gestapelt werden soll Liste. Ist der Text vertikal gestapelt, wird die Einstellung für die Textdrehung mit 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.

Rückflug

RangeList: Diese Bereichsliste zur 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

`setWrap(isWrapEnabled)`

Legen Sie den Textumbruch für jede Range in der Bereichsliste fest. Zellen, bei denen die Größe des Wrappings aktiviert ist um den gesamten Inhalt anzuzeigen. In Zellen mit deaktiviertem Zeilenumbruch werden so viele Informationen wie möglich in der Zelle angezeigt. ohne dass die Größe geändert wird oder auf mehrere Zeilen verlaufen muss.

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

Rückflug

RangeList: Diese Bereichsliste zur 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

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

Rückflug

RangeList: Diese Bereichsliste zur 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

`trimWhitespace()`

Passt den Leerraum (z. B. Leerzeichen, Tabulatoren oder neue Zeilen) in allen Zellen in dieser Bereichsliste an. Entfernt sämtliche Leerzeichen am Anfang und Ende jedes Zellentextes und verkleinert die Teilsequenz verbleibenden Leerraumzeichen 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)']

Rückflug

RangeList: Diese Bereichsliste zur 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

Weitere Informationen

Range.trimWhitespace()

`uncheck()`

Ändert den Status der Kästchen im Bereich zu „Deaktiviert“ Die Zellen im Bereich werden ignoriert. die derzeit weder den aktivierten noch den deaktivierten 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();

Rückflug

RangeList: Diese Bereichsliste zur 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