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

Class RangeList

Kolekcja co najmniej jednej instancji Range w tym samym arkuszu. Tej klasy możesz używać do wykonywania operacji na kolekcjach sąsiadujących ze sobą zakresach lub komórkach.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`RangeList`	Wybiera listę instancji `Range`.
`breakApart()`	`RangeList`	Ponownie podziel wszystkie komórki w poziomie lub w pionie na liście 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ł weryfikacji danych dla każdego elementu `Range` na liście zakresów.
`clear(options)`	`RangeList`	Czyści zakres treści, formatu, reguł weryfikacji danych i komentarzy zgodnie z określonymi opcjami.
`clearContent()`	`RangeList`	Usuwa zawartość każdego elementu `Range` z listy zakresów, zachowując formatowanie.
`clearDataValidations()`	`RangeList`	Czyści reguły weryfikacji danych dla każdego typu `Range` na liście zakresów.
`clearFormat()`	`RangeList`	Czyści formatowanie tekstu dla każdego elementu `Range` na liście zakresów.
`clearNote()`	`RangeList`	Czyści notatkę dla każdego elementu `Range` na liście zakresów.
`getRanges()`	`Range[]`	Zwraca listę co najmniej jednej instancji `Range` w tym samym arkuszu.
`insertCheckboxes()`	`RangeList`	Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane za pomocą zasady `true` jako zaznaczone i `false` do odznaczenia.
`insertCheckboxes(checkedValue)`	`RangeList`	Wstawia pola wyboru w każdej komórce zakresu, Skonfigurowane z użyciem niestandardowej wartości zaznaczonej i pustego ciągu niezaznaczonego.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Wstawia pola wyboru do każdej komórki w zakresie wraz z wartościami niestandardowymi dla stanów zaznaczenia i odznaczonych.
`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 kolor tła na określony kolor 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`	Ustawia właściwość obramowania dla koloru lub stylu dla każdego elementu `Range` na liście zakresów.
`setFontColor(color)`	`RangeList`	Ustawia kolor czcionki w przypadku każdego elementu `Range` z listy.
`setFontFamily(fontFamily)`	`RangeList`	Ustawia rodzinę czcionek dla każdego elementu `Range` na liście zakresów.
`setFontLine(fontLine)`	`RangeList`	Ustawia styl linii czcionek w każdym polu `Range` z listy.
`setFontSize(size)`	`RangeList`	Ustawia rozmiar czcionki (w punktach) każdego elementu `Range` z listy.
`setFontStyle(fontStyle)`	`RangeList`	Ustaw styl czcionki w przypadku każdego elementu `Range` z listy.
`setFontWeight(fontWeight)`	`RangeList`	Ustaw grubość czcionki dla każdego elementu `Range` na liście zakresów.
`setFormula(formula)`	`RangeList`	Aktualizuje formułę dla każdego typu `Range` na liście zakresów.
`setFormulaR1C1(formula)`	`RangeList`	Aktualizuje formułę dla każdego typu `Range` na liście zakresów.
`setHorizontalAlignment(alignment)`	`RangeList`	Wyrównaj w poziomie dla każdego elementu `Range` z listy zakresów.
`setNote(note)`	`RangeList`	Ustawia tekst notatki dla każdego wymiaru `Range` z listy.
`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żde `Range` na liście zakresów ma wyświetlać hiperlinki.
`setTextDirection(direction)`	`RangeList`	Ustawia kierunek tekstowy dla komórek w każdej kolumnie `Range` na liście zakresów.
`setTextRotation(degrees)`	`RangeList`	Ustawia ustawienia rotacji tekstu w komórkach w każdej kolumnie `Range` na liście zakresów.
`setValue(value)`	`RangeList`	Ustawia wartość dla każdego elementu `Range` na liście zakresów.
`setVerticalAlignment(alignment)`	`RangeList`	Ustaw wyrównanie w pionie do każdego elementu `Range` na liście zakresów.
`setVerticalText(isVertical)`	`RangeList`	Określa, czy tekst każdej komórki `Range` na liście zakresów ma być ułożony.
`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` z listy.
`trimWhitespace()`	`RangeList`	Przycina spacje do wszystkich komórek na tej liście zakresów (np. spacje, karty lub nowe wiersze).
`uncheck()`	`RangeList`	Zmienia stan pól wyboru w zakresie na „odznaczone”.

Szczegółowa dokumentacja

`activate()`

Wybiera listę instancji Range. Ostatni zakres na liście jest ustawiony na active range.

Uwaga: umożliwia to zaznaczenie wielu 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();

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`breakApart()`

Ponownie podziel wszystkie komórki w poziomie lub w pionie na liście zakresów na poszczególne komórki.

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

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`check()`

Zmienia stan pól wyboru na „zaznaczone”. Ignoruje komórki z zakresu, który obecnie nie zawiera żadnej zaznaczonej lub nieskonfigurowanej 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();

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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ł weryfikacji 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();

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`clear(options)`

Czyści zakres treści, formatu, reguł weryfikacji danych i komentarzy zgodnie z określonymi opcjami. Domyślnie wszystkie dane są wyczyszczone.

// 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 usunąć tylko komentarze
`contentsOnly`	`Boolean`	Określa, czy chcesz usunąć tylko zawartość.
`formatOnly`	`Boolean`	Czy usunąć tylko format – pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł weryfikacji danych.
`validationsOnly`	`Boolean`	Określa, czy usunąć tylko reguły weryfikacji danych.
`skipFilteredRows`	`Boolean`	Określa, czy uniknąć czyszczenia odfiltrowanych wierszy.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`clearContent()`

Usuwa zawartość każdego elementu Range z listy zakresów, zachowując formatowanie.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`clearDataValidations()`

Czyści reguły weryfikacji danych dla każdego typu Range na liście zakresów.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`clearFormat()`

Czyści formatowanie tekstu dla każdego elementu Range na liście zakresów.

To spowoduje usunięcie formatowania tekstu dla każdego zakresu, ale nie spowoduje zresetowania żadnych reguł formatowania liczb.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`clearNote()`

Czyści notatkę dla każdego elementu Range na liście zakresów.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getRanges()`

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

Zwróć

Range[] – lista zakresów,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`insertCheckboxes()`

Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane za pomocą zasady true jako zaznaczone i false do odznaczenia. 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();

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`insertCheckboxes(checkedValue)`

Wstawia pola wyboru w każdej komórce zakresu, Skonfigurowane z użyciem niestandardowej wartości zaznaczonej i pustego ciągu niezaznaczonego. Ustawia wartość każdej komórki w zakresie na pusty ciąg znaków.

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`	Sprawdzana wartość sprawdzania poprawności danych pola wyboru.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wraz z wartościami niestandardowymi dla stanów zaznaczenia i odznaczonych. Ustawia wartość każdej komórki w zakresie na niestandardową odznaczoną wartość.

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`	Sprawdzana wartość sprawdzania poprawności danych pola wyboru.
`uncheckedValue`	`Object`	Niezaznaczona wartość do weryfikacji danych pola wyboru.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`removeCheckboxes()`

Usuwa wszystkie pola wyboru z zakresu. Usuwa walidację danych każdej komórki i dodatkowo usuwa jej wartość, jeśli komórka zawiera wartość zaznaczoną lub odznaczoną.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wyrażony w notacji CSS, na przykład '#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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setBackgroundRGB(red, green, blue)`

Ustawia kolor tła na określony kolor RGB. To wygodny komunikat dotyczący wywołania 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`	Zielona wartość w notacji RGB.
`blue`	`Integer`	Niebieska wartość w notacji RGB.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 (on), 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` dla obramowania, `false` – brak, `null` bez zmian.
`left`	`Boolean`	`true` dla obramowania, `false` – brak, `null` bez zmian.
`bottom`	`Boolean`	`true` dla obramowania, `false` – brak, `null` bez zmian.
`right`	`Boolean`	`true` dla obramowania, `false` – brak, `null` bez zmian.
`vertical`	`Boolean`	`true` – obramowanie wewnętrzne, `false` – brak, `null` – bez zmian.
`horizontal`	`Boolean`	`true` – obramowanie wewnętrzne w poziomie, `false` – brak, `null` – bez zmian.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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)`

Ustawia właściwość obramowania dla koloru lub stylu dla każdego elementu Range na liście zakresów. Prawidłowe wartości to true (on), false (wyłączony) i null (bez zmian). Kolor jest podany w notacji CSS, na przykład '#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` dla obramowania, `false` – brak, `null` bez zmian.
`left`	`Boolean`	`true` dla obramowania, `false` – brak, `null` bez zmian.
`bottom`	`Boolean`	`true` dla obramowania, `false` – brak, `null` bez zmian.
`right`	`Boolean`	`true` dla obramowania, `false` – brak, `null` bez zmian.
`vertical`	`Boolean`	`true` – obramowanie wewnętrzne, `false` – brak, `null` – bez zmian.
`horizontal`	`Boolean`	`true` – obramowanie wewnętrzne w poziomie, `false` – brak, `null` – bez zmian.
`color`	`String`	Kolor obramowania w notacji CSS, np. `'#ffffff'` lub `'white'`, `null`, aby zmienić kolor domyślny (czarny).
`style`	`BorderStyle`	Styl obramowań, `null` – styl domyślny (ciągły).

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setFontColor(color)`

Ustawia kolor czcionki w przypadku każdego elementu Range z listy. Kolor jest podany w notacji CSS, na przykład '#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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 za pomocą identyfikatora ciągu, takiego jak 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setFontLine(fontLine)`

Ustawia styl linii czcionek w każdym polu Range z listy. Opcje stylu linii to 'underline', 'line-through' lub '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 czcionki.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setFontSize(size)`

Ustawia rozmiar czcionki (w punktach) każdego elementu Range z listy.

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

Parametry

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setFontStyle(fontStyle)`

Ustaw styl czcionki w przypadku każdego elementu Range z listy. Dostępne typy czcionek to 'italic' lub '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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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. 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`	Waga czcionki: `'bold'` lub `'normal'`; wartość `null` resetuje grubość czcionki.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setFormula(formula)`

Aktualizuje formułę dla każdego typu 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setFormulaR1C1(formula)`

Aktualizuje formułę dla każdego typu 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setHorizontalAlignment(alignment)`

Wyrównaj w poziomie dla każdego elementu Range z listy zakresów. Dostępne opcje wyrównania to 'left', 'center' lub '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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wymiaru Range z listy.

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, który chcesz ustawić; usunięcie wartości `null` spowoduje usunięcie notatki.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 znajdziesz w przewodniku po formatowaniu daty i liczby w interfejsie API Arkuszy.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setShowHyperlink(showHyperlink)`

Określa, czy każde 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setTextDirection(direction)`

Ustawia kierunek tekstowy dla komórek w każdej kolumnie Range na liście zakresów. Jeśli określony kierunek to null, kierunek zostanie ustalony, a następnie ustawiony.

// 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`	Oczekiwany kierunek tekstu. Jeśli `null` jest określony, przed ustawieniem.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setTextRotation(degrees)`

Ustawia ustawienia rotacji tekstu w komórkach w każdej kolumnie Range na liście zakresów. Dane wejściowe odpowiadają kątowi między standardową orientacją tekstową a żądanym położeniem. Wartość wejściowa 0 oznacza, że tekst jest ustawiony na standardową orientację.

W przypadku tekstu tekstowego od lewej do prawej kąty dodatnie są skierowane w lewo, a od prawej do lewej.

// 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`	Żądany kąt między standardową a żądaną orientacją. W przypadku tekstu od lewej do prawej dodatnie kąty są ustawione w lewo.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setValue(value)`

Ustawia wartość dla każdego elementu Range na liście zakresów. Wartość może być liczbą, ciągiem znaków, wartością logiczną lub datą. Jeśli zaczyna się od ciągu '=&#39, 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setVerticalAlignment(alignment)`

Ustaw wyrównanie w pionie do każdego elementu Range na liście zakresów. Dostępne opcje wyrównania 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setVerticalText(isVertical)`

Określa, czy tekst każdej komórki Range na liście zakresów ma być ułożony. Jeśli tekst jest ułożony pionowo, stopień obrotu tekstu jest ignorowany.

// 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 być ułożony, czy nie.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 rozmiarem zawijania wyświetlają pełną treść. Komórki z wyłączonym zawijaniem wyświetlają jak najwięcej reklam bez zmiany rozmiaru lub wyświetlania w wielu wierszach.

// 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 zawijać tekst, czy nie.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 z listy.

// 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`	Żądana strategia dodawania kodów.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`trimWhitespace()`

Przycina spacje do wszystkich komórek na tej liście zakresów (np. spacje, karty lub nowe wiersze). Usuwa wszystkie odstępy z początku i końca każdej komórki oraz zmniejsza ciąg znaków następujących po pozostałych znakach odstępu.

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 na „Niezaznaczone”. Ignoruje komórki z zakresu, który obecnie nie zawiera żadnej zaznaczonej lub nieskonfigurowanej 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();

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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