Ta strona została przetłumaczona przez Cloud Translation API.

Class RangeList

Zbiór zawierający co najmniej 1 instancję Range w tym samym arkuszu. Za pomocą tej klasy możesz wykonywać operacje na zbiorach zakresów lub komórek, które nie sąsiadują ze sobą.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`RangeList`	Wybiera listę instancji (`Range`).
`breakApart()`	`RangeList`	Ponownie podziel wszystkie scalone w poziomie lub pionowo komórki z listy zakresów na poszczególne komórki.
`check()`	`RangeList`	Zmienia stan pól wyboru w zakresie na „zaznaczone”.
`clear()`	`RangeList`	Czyści zakres treści, formatów i reguł sprawdzania poprawności danych dla każdego elementu `Range` na liście zakresów.
`clear(options)`	`RangeList`	Usuwa zakres treści, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z określonymi opcjami.
`clearContent()`	`RangeList`	Usuwa treść każdego elementu `Range` na liście zakresów, pozostawiając formatowanie bez zmian.
`clearDataValidations()`	`RangeList`	Czyści reguły sprawdzania poprawności danych dla każdego elementu `Range` na liście zakresów.
`clearFormat()`	`RangeList`	Usuwa formatowanie tekstu w każdym polu `Range` na liście zakresów.
`clearNote()`	`RangeList`	Usuwa notatkę z każdego elementu `Range` na liście zakresów.
`getRanges()`	`Range[]`	Zwraca listę co najmniej 1 instancji `Range` w tym samym arkuszu.
`insertCheckboxes()`	`RangeList`	Wstawia pola wyboru w każdej komórce w zakresie z zaznaczoną wartością `true` i odznaczoną `false`.
`insertCheckboxes(checkedValue)`	`RangeList`	Wstawia pola wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem znaków, jeśli nie jest zaznaczone.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Wstawia pola wyboru do każdej komórki w zakresie skonfigurowanych przy użyciu niestandardowych wartości stanów zaznaczonego i odznaczonego.
`removeCheckboxes()`	`RangeList`	Usuwa wszystkie pola wyboru z zakresu.
`setBackground(color)`	`RangeList`	Ustawia kolor tła każdego elementu `Range` na liście zakresów.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Ustawia podany kolor tła RGB.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Ustawia właściwość obramowania dla każdego elementu `Range` na liście zakresów.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Dla każdego elementu `Range` na liście zakresów ustawia właściwość obramowania z kolorem lub stylem.
`setFontColor(color)`	`RangeList`	Ustawia kolor czcionki dla każdego elementu `Range` na liście zakresów.
`setFontFamily(fontFamily)`	`RangeList`	Ustawia rodzinę czcionek dla każdego elementu `Range` na liście zakresów.
`setFontLine(fontLine)`	`RangeList`	Ustawia styl linii czcionki dla każdego elementu `Range` na liście zakresów.
`setFontSize(size)`	`RangeList`	Ustawia rozmiar czcionki (w punktach) dla każdego elementu `Range` na liście zakresów.
`setFontStyle(fontStyle)`	`RangeList`	Ustaw styl czcionki dla każdego elementu `Range` na liście zakresów.
`setFontWeight(fontWeight)`	`RangeList`	Ustaw grubość czcionki dla każdego elementu `Range` na liście zakresów.
`setFormula(formula)`	`RangeList`	Aktualizuje formułę dla każdego elementu `Range` na liście zakresów.
`setFormulaR1C1(formula)`	`RangeList`	Aktualizuje formułę dla każdego elementu `Range` na liście zakresów.
`setHorizontalAlignment(alignment)`	`RangeList`	Ustaw wyrównanie w poziomie dla każdego elementu `Range` na liście zakresów.
`setNote(note)`	`RangeList`	Ustawia tekst notatki dla każdego elementu `Range` na liście zakresów.
`setNumberFormat(numberFormat)`	`RangeList`	Ustawia format liczb lub daty dla każdego elementu `Range` na liście zakresów.
`setShowHyperlink(showHyperlink)`	`RangeList`	Określa, czy każdy element `Range` na liście zakresów ma wyświetlać hiperlinki.
`setTextDirection(direction)`	`RangeList`	Ustawia kierunek tekstu w komórkach każdego elementu `Range` na liście zakresu.
`setTextRotation(degrees)`	`RangeList`	Ustawia ustawienia rotacji tekstu dla komórek w każdym elemencie `Range` na liście zakresów.
`setValue(value)`	`RangeList`	Ustawia wartość każdego parametru `Range` na liście zakresów.
`setVerticalAlignment(alignment)`	`RangeList`	Ustaw wyrównanie w pionie dla każdego elementu `Range` na liście zakresów.
`setVerticalText(isVertical)`	`RangeList`	Określa, czy dla każdego elementu `Range` na liście zakresu ma być wyświetlany tekst w komórkach.
`setWrap(isWrapEnabled)`	`RangeList`	Ustaw zawijanie tekstu dla każdego elementu `Range` na liście zakresów.
`setWrapStrategy(strategy)`	`RangeList`	Ustawia strategię zawijania tekstu dla każdego elementu `Range` na liście zakresów.
`trimWhitespace()`	`RangeList`	Usuwa odstępy (np. spacje, tabulatory lub nowe wiersze) każdej komórki na liście zakresów.
`uncheck()`	`RangeList`	Zmienia stan pól wyboru w zakresie na „odznaczone”.

Szczegółowa dokumentacja

`activate()`

Wybiera listę instancji (Range). Ostatni zakres na liście to active range.

Uwaga: w ten sposób możesz zaznaczyć wiele zakresów.

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

Powroty

RangeList – lista aktywnych zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`breakApart()`

Ponownie podziel wszystkie scalone w poziomie lub pionowo komórki z listy zakresów na poszczególne komórki.

Wywołanie tej funkcji na liście zakresów jest równoważne z wyborem zestawu zakresów i pozycji menu Format > Scal > Rozdziel.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`check()`

Zmienia stan pól wyboru w zakresie na „zaznaczone”. Ignoruje komórki w zakresie, które obecnie nie zawierają skonfigurowanej ani zaznaczonej, ani niezaznaczonej wartości.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`clear()`

Czyści zakres treści, formatów i reguł sprawdzania poprawności danych dla każdego elementu Range na liście zakresów.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`clear(options)`

Usuwa zakres treści, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z określonymi opcjami. Domyślnie wszystkie dane są czyszczone.

// 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});

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`commentsOnly`	`Boolean`	Czy usuwać tylko komentarze.
`contentsOnly`	`Boolean`	Określa, czy usunąć samą zawartość.
`formatOnly`	`Boolean`	Określa, czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu usuwa też reguły sprawdzania poprawności danych.
`validationsOnly`	`Boolean`	Określa, czy wyczyścić tylko reguły sprawdzania poprawności danych.
`skipFilteredRows`	`Boolean`	Określa, czy nie wyczyścić odfiltrowanych wierszy.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`clearContent()`

Usuwa treść każdego elementu Range na liście zakresów, pozostawiając formatowanie bez zmian.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`clearDataValidations()`

Czyści reguły sprawdzania poprawności danych dla każdego elementu Range na liście zakresów.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`clearFormat()`

Usuwa formatowanie tekstu w każdym polu Range na liście zakresów.

Spowoduje to usunięcie formatowania tekstu w każdym zakresie, ale nie spowoduje zresetowania żadnych reguł formatowania liczb.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`clearNote()`

Usuwa notatkę z każdego elementu Range na liście zakresów.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getRanges()`

Zwraca listę co najmniej 1 instancji Range w tym samym arkuszu.

Powroty

Range[] – lista zakresów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`insertCheckboxes()`

Wstawia pola wyboru w każdej komórce w zakresie z zaznaczoną wartością true i odznaczoną false. Ustawia wartość wszystkich komórek w zakresie na false.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`insertCheckboxes(checkedValue)`

Wstawia pola wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem znaków, jeśli nie jest zaznaczone. Ustawia pusty ciąg znaków w każdej komórce w zakresie.

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

Parametry

Nazwa	Typ	Opis
`checkedValue`	`Object`	Wartość pola wyboru sprawdzania poprawności danych.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Wstawia pola wyboru do każdej komórki w zakresie skonfigurowanych przy użyciu niestandardowych wartości stanów zaznaczonego i odznaczonego. Ustawia wartość każdej komórki w zakresie na niestandardową wartość niezaznaczoną.

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

Parametry

Nazwa	Typ	Opis
`checkedValue`	`Object`	Wartość pola wyboru sprawdzania poprawności danych.
`uncheckedValue`	`Object`	Odznaczona wartość sprawdzania poprawności danych pola wyboru.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`removeCheckboxes()`

Usuwa wszystkie pola wyboru z zakresu. Czyści funkcję sprawdzania poprawności danych w każdej komórce i usuwa dodatkowo jej wartość, jeśli komórka zawiera zaznaczoną lub niezaznaczoną wartość.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setBackground(color)`

Ustawia kolor tła każdego elementu Range na liście zakresów. Kolor jest podawany w notacji CSS, np. '#ffffff' lub 'white'.

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

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kod koloru tła w notacji CSS, np. `'#ffffff'` lub `'white'`. Wartość `null` resetuje kolor.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setBackgroundRGB(red, green, blue)`

Ustawia podany kolor tła RGB. Jest to wygodny kod podczas rozmowy w usłudze setBackground(color).

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

Parametry

Nazwa	Typ	Opis
`red`	`Integer`	Wartość czerwona w notacji RGB.
`green`	`Integer`	Wartość zielona w notacji RGB.
`blue`	`Integer`	Wartość niebieska w notacji RGB.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

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

Ustawia właściwość obramowania dla każdego elementu Range na liście zakresów. Prawidłowe wartości to true (wł.), false (wyłączony) i null (bez zmian).

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

Parametry

Nazwa	Typ	Opis
`top`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`left`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`bottom`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`right`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`vertical`	`Boolean`	`true` – obramowanie pionowe, `false` – brak, `null` – bez zmian.
`horizontal`	`Boolean`	`true` – obramowanie wewnętrzne, `false` – brak, `null` – bez zmian.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

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

Dla każdego elementu Range na liście zakresów ustawia właściwość obramowania z kolorem lub stylem. Prawidłowe wartości to true (włączony), false (wyłączony) i null (bez zmian). Kolor jest reprezentowany w notacji CSS, np. '#ffffff' lub '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);

Parametry

Nazwa	Typ	Opis
`top`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`left`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`bottom`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`right`	`Boolean`	`true` – obramowanie, `false` – brak, `null`, bez zmian.
`vertical`	`Boolean`	`true` – obramowanie pionowe, `false` – brak, `null` – bez zmian.
`horizontal`	`Boolean`	`true` – obramowanie wewnętrzne, `false` – brak, `null` – bez zmian.
`color`	`String`	Kolor obramowania w notacji CSS, np. `'#ffffff'` lub `'white'`; `null` w przypadku koloru domyślnego (czarnego).
`style`	`BorderStyle`	Styl obramowania, `null`, który oznacza styl domyślny (ciągły).

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFontColor(color)`

Ustawia kolor czcionki dla każdego elementu Range na liście zakresów. Kolor jest reprezentowany w notacji CSS, np. '#ffffff' lub 'white'.

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

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor czcionki w notacji CSS, np. `'#ffffff'` lub `'white'`; wartość `null` resetuje kolor.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFontFamily(fontFamily)`

Ustawia rodzinę czcionek dla każdego elementu Range na liście zakresów. Rodzina czcionek jest opisana identyfikatorem ciągu znaków, np. Arial lub Roboto.

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

Parametry

Nazwa	Typ	Opis
`fontFamily`	`String`	Rodzina czcionek do ustawienia. Wartość `null` resetuje rodzinę czcionek.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFontLine(fontLine)`

Ustawia styl linii czcionki dla każdego elementu Range na liście zakresów. Dostępne style linii to 'underline', 'line-through' i 'none'.

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

Parametry

Nazwa	Typ	Opis
`fontLine`	`String`	Styl linii czcionki (`'underline'`, `'line-through'` lub `'none'`). Wartość `null` resetuje styl linii czcionki.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFontSize(size)`

Ustawia rozmiar czcionki (w punktach) dla każdego elementu Range na liście zakresów.

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

Parametry

Nazwa	Typ	Opis
`size`	`Integer`	Rozmiar czcionki.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFontStyle(fontStyle)`

Ustaw styl czcionki dla każdego elementu Range na liście zakresów. Dostępne opcje to 'italic' i 'normal'.

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

Parametry

Nazwa	Typ	Opis
`fontStyle`	`String`	Styl czcionki, `'italic'` lub `'normal'`; wartość `null` resetuje styl czcionki.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFontWeight(fontWeight)`

Ustaw grubość czcionki dla każdego elementu Range na liście zakresów. Dostępne opcje grubości czcionki to 'normal' lub 'bold'.

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

Parametry

Nazwa	Typ	Opis
`fontWeight`	`String`	Grubość czcionki (`'bold'` lub `'normal'`). Wartość `null` resetuje grubość czcionki.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFormula(formula)`

Aktualizuje formułę dla każdego elementu Range na liście zakresów. Podana formuła musi być w notacji A1.

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

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Ciąg znaków reprezentujący formułę do ustawienia.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setFormulaR1C1(formula)`

Aktualizuje formułę dla każdego elementu Range na liście zakresów. Podana formuła musi być w notacji R1C1.

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])');

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Formuła ciągu znaków.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setHorizontalAlignment(alignment)`

Ustaw wyrównanie w poziomie dla każdego elementu Range na liście zakresów. Dostępne opcje wyrównywania to 'left', 'center' i 'right'.

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

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie (`'left'`, `'center'` lub `'normal'`). Wartość `null` resetuje wyrównanie.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setNote(note)`

Ustawia tekst notatki dla każdego elementu Range na liście zakresów.

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

Parametry

Nazwa	Typ	Opis
`note`	`String`	Tekst notatki do ustawienia. Wartość `null` usuwa notatkę.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setNumberFormat(numberFormat)`

Ustawia format liczb lub daty dla każdego elementu Range na liście zakresów.

Akceptowane wzorce formatowania zostały opisane w przewodniku po formatowaniu dat i liczb w interfejsie Arkuszy Google.

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

Parametry

Nazwa	Typ	Opis
`numberFormat`	`String`	Ciąg w formacie liczby.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setShowHyperlink(showHyperlink)`

Określa, czy każdy element Range na liście zakresów ma wyświetlać hiperlinki.

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

Parametry

Nazwa	Typ	Opis
`showHyperlink`	`Boolean`	Określa, czy hiperlink ma być wyświetlany.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setTextDirection(direction)`

Ustawia kierunek tekstu w komórkach każdego elementu Range na liście zakresu. Jeśli określony kierunek to null, kierunek jest określany, a następnie ustawiany.

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

Parametry

Nazwa	Typ	Opis
`direction`	`TextDirection`	Żądany kierunek tekstu. Jeśli ma wartość `null`, kierunek jest ustalany przed ustawieniem.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setTextRotation(degrees)`

Ustawia ustawienia rotacji tekstu dla komórek w każdym elemencie Range na liście zakresów. Dane wejściowe odpowiadają kątowi między standardową orientacją tekstu a żądaną orientacją. Wartość 0 oznacza, że tekst ma orientację standardową.

W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są wykonywane w lewo, a od prawej do lewej – w prawo.

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

Parametry

Nazwa	Typ	Opis
`degrees`	`Integer`	Wybrany kąt między orientacją standardową a żądaną. W przypadku tekstu od lewej do prawej kąty dodatnie są wykonywane w kierunku przeciwnym do ruchu wskazówek zegara.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setValue(value)`

Ustawia wartość każdego parametru Range na liście zakresów. Może to być liczba, ciąg znaków, wartość logiczna lub data. Jeśli zaczyna się od „=”, jest interpretowany jako formuła.

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

Parametry

Nazwa	Typ	Opis
`value`	`Object`	Wartość zakresu.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setVerticalAlignment(alignment)`

Ustaw wyrównanie w pionie dla każdego elementu Range na liście zakresów. Dostępne opcje wyrównywania to 'top', 'middle' lub '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");

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie (`'top'`, `'middle'` lub `'bottom'`). Wartość `null` resetuje wyrównanie.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setVerticalText(isVertical)`

Określa, czy dla każdego elementu Range na liście zakresu ma być wyświetlany tekst w komórkach. Jeśli tekst jest ułożony pionowo, ustawienie jego obrotu jest ignorowane.

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

Parametry

Nazwa	Typ	Opis
`isVertical`	`Boolean`	Określa, czy tekst ma się nakładać na stos.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setWrap(isWrapEnabled)`

Ustaw zawijanie tekstu dla każdego elementu Range na liście zakresów. Komórki z włączonym zawijaniem zmieniają rozmiar, by wyświetlić ich pełną zawartość. Komórki z wyłączonym zawijaniem wyświetlają się w jak największym stopniu bez konieczności zmiany rozmiaru i przejścia do wielu wierszy.

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

Parametry

Nazwa	Typ	Opis
`isWrapEnabled`	`Boolean`	Określa, czy tekst ma być zawijany.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`setWrapStrategy(strategy)`

Ustawia strategię zawijania tekstu dla każdego elementu Range na liście zakresów.

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

Parametry

Nazwa	Typ	Opis
`strategy`	`WrapStrategy`	Docelowa strategia pakowania.

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`trimWhitespace()`

Usuwa odstępy (np. spacje, tabulatory lub nowe wiersze) każdej komórki na liście zakresów. Usuwa wszystkie spacje z początku i końca tekstu w każdej komórce oraz zmniejsza kolejne odstępy do 1 spacji.

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)']

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też

Range.trimWhitespace()

`uncheck()`

Zmienia stan pól wyboru w zakresie na „odznaczone”. Ignoruje komórki w zakresie, które obecnie nie zawierają skonfigurowanej ani zaznaczonej, ani niezaznaczonej wartości.

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

Powroty

RangeList – ta lista zakresów na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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