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

Class RangeList

Zbiór co najmniej 1 instancji Range na tym samym arkuszu. Z tej klasy możesz korzystać, aby stosować operacje na zbiorach niesąsiadujących zakresów lub komórek.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`RangeList`	Wybiera listę instancji `Range`.
`breakApart()`	`RangeList`	Rozdziel wszystkie komórki scalone poziomo lub pionowo zawarte w liście zakresów na pojedyncze komórki.
`check()`	`RangeList`	Stan pól wyboru w zakresie zmieni się na „zaznaczone”.
`clear()`	`RangeList`	Czyści zakres treści, formatów i reguł walidacji danych dla każdego `Range` na liście zakresów.
`clear(options)`	`RangeList`	Czyści zakres treści, format, reguły sprawdzania poprawności danych i komentarze zgodnie z określonymi opcjami.
`clearContent()`	`RangeList`	Czyści zawartość każdego elementu `Range` na liście zakresów, nie zmieniając formatowania.
`clearDataValidations()`	`RangeList`	Czyści reguły sprawdzania poprawności danych dla każdego `Range` na liście zakresów.
`clearFormat()`	`RangeList`	Usuwa formatowanie tekstu dla każdego `Range` na liście zakresów.
`clearNote()`	`RangeList`	Czyści notatkę dla każdego `Range` na liście zakresów.
`getRanges()`	`Range[]`	Zwraca listę co najmniej 1 wystąpienia funkcji `Range` na tym samym arkuszu.
`insertCheckboxes()`	`RangeList`	Wstawia pola wyboru w każdej komórce w zakresie, skonfigurowane za pomocą `true` dla zaznaczonych i `false` dla niezaznaczonych.
`insertCheckboxes(checkedValue)`	`RangeList`	Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonego pola i pustym ciągiem znaków dla niezaznaczonego pola.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Wstawia pola wyboru w każdej komórce zakresu, skonfigurowane z niestandardowymi wartościami dla zaznaczonych i niezaznaczonych stanów.
`removeCheckboxes()`	`RangeList`	usuwa wszystkie pola wyboru z zakresu.
`setBackground(color)`	`RangeList`	Ustawia kolor tła dla każdego `Range` na liście zakresów.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Ustawia tło na podany 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 (kolor lub styl) dla każdego kroku `Range` na liście zakresów.
`setFontColor(color)`	`RangeList`	Ustawia kolor czcionki dla każdego `Range` na liście zakresów.
`setFontFamily(fontFamily)`	`RangeList`	Ustawia rodzinę czcionek dla każdego `Range` na liście zakresów.
`setFontLine(fontLine)`	`RangeList`	Ustawia styl linii czcionki dla każdego `Range` na liście zakresów.
`setFontSize(size)`	`RangeList`	Ustawia rozmiar czcionki (w punktach) dla każdego `Range` na liście zakresów.
`setFontStyle(fontStyle)`	`RangeList`	Ustaw styl czcionki dla każdego `Range` na liście zakresów.
`setFontWeight(fontWeight)`	`RangeList`	Ustaw wagę czcionki dla każdego `Range` na liście zakresów.
`setFormula(formula)`	`RangeList`	Zaktualizuje formułę dla każdego `Range` na liście zakresów.
`setFormulaR1C1(formula)`	`RangeList`	Zaktualizuje formułę dla każdego `Range` na liście zakresów.
`setHorizontalAlignment(alignment)`	`RangeList`	Ustaw wyrównanie poziome dla każdego `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 liczby 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 w każdym `Range` na liście zakresów.
`setTextRotation(degrees)`	`RangeList`	Ustawia ustawienia obracania tekstu dla komórek w każdym `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 pionowe dla każdego `Range` na liście zakresów.
`setVerticalText(isVertical)`	`RangeList`	Określa, czy tekst w komórkach dla każdego `Range` na liście zakresów ma być ułożony w stos.
`setWrap(isWrapEnabled)`	`RangeList`	Ustaw wcięcie tekstu dla każdego elementu `Range` na liście zakresów.
`setWrapStrategy(strategy)`	`RangeList`	Ustawia strategię przenoszenia tekstu dla każdego `Range` na liście zakresów.
`trimWhitespace()`	`RangeList`	Obcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce na liście zakresów.
`uncheck()`	`RangeList`	Stan pól wyboru w zakresie zostanie zmieniony na „niezaznaczone”.

Szczegółowa dokumentacja

`activate()`

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

Uwaga: to pozwala na wielokrotny wybór wielu zakresów.

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

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

Powrót

RangeList – lista aktywnych zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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()`

Rozdziel wszystkie komórki scalone poziomo lub pionowo zawarte w liście zakresów na pojedyncze komórki.

Wywołanie tej funkcji na liście zakresów jest równoważne wybraniu zestawu zakresów i kliknięciu Formatowanie > Scal > Rozłącz w menu Arkuszy.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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”. Pomija komórki w zakresie, które nie zawierają obecnie skonfigurowanej wartości zaznaczonej ani niezaznaczonej.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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ł walidacji danych dla każdego Range na liście zakresów.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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)`

Czyści zakres treści, format, reguły sprawdzania poprawności danych i komentarze zgodnie z określonymi opcjami. Domyślnie wszystkie dane są usuwane.

// 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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Obiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`commentsOnly`	`Boolean`	Określa, czy usunąć tylko komentarze.
`contentsOnly`	`Boolean`	Określa, czy ma zostać wyczyszczona tylko zawartość.
`formatOnly`	`Boolean`	Czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł sprawdzania poprawności danych.
`validationsOnly`	`Boolean`	Określ, czy chcesz usunąć tylko reguły sprawdzania poprawności danych.
`skipFilteredRows`	`Boolean`	Określa, czy należy unikać usuwania odfiltrowanych wierszy.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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()`

Czyści zawartość każdego elementu Range na liście zakresów, nie zmieniając formatowania.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 Range na liście zakresów.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 dla każdego Range na liście zakresów.

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

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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()`

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

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 wystąpienia funkcji Range na tym samym arkuszu.

Powrót

Range[] – lista zakresów.

Autoryzacja

Skrypty, które korzystają 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, skonfigurowane za pomocą true dla zaznaczonych i false dla niezaznaczonych. Ustawia wartość wszystkich komórek w zakresie na false.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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, skonfigurowane z niestandardową wartością dla zaznaczonego pola i pustym ciągiem znaków dla niezaznaczonego pola. Ustawia wartość każdej komórki w zakresie na pusty ciąg znaków.

const 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`	Zaznaczona wartość walidacji danych pola wyboru.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 w każdej komórce zakresu, skonfigurowane z niestandardowymi wartościami dla zaznaczonych i niezaznaczonych stanów. Ustawia wartość każdej komórki w zakresie na niestandardową wartość niezaznaczoną.

const 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`	Zaznaczona wartość walidacji danych pola wyboru.
`uncheckedValue`	`Object`	Wartość niezaznaczonego pola wyboru w przypadku walidacji danych.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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. Usuwa sprawdzanie poprawności danych z każdej komórki, a dodatkowo usuwa jej wartość, jeśli zawiera ona wartość zaznaczoną lub niezaznaczoną.

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

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

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

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 dla każdego Range na liście zakresów. Kolor jest reprezentowany za pomocą zapisu w notacji CSS, np. '#ffffff' lub 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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` zeruje kolor.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 tło na podany kolor RGB. Jest to wygodna obudowa wywołania setBackground(color).

const sheet = SpreadsheetApp.getActiveSheet();
const 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ść czerwonego w notacji RGB.
`green`	`Integer`	Wartość zielonego w notacji RGB.
`blue`	`Integer`	Wartość niebieskiego w notacji RGB.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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łączone), false (wyłączone) i null (bez zmian).

const sheet = SpreadsheetApp.getActiveSheet();
const 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` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`left`	`Boolean`	`true` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`bottom`	`Boolean`	`true` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`right`	`Boolean`	`true` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`vertical`	`Boolean`	`true` – wewnętrzne pionowe obramowania, `false` – brak obramowania, `null` – brak zmian.
`horizontal`	`Boolean`	`true` – wewnętrzne poziome obramowania, `false` – brak obramowania, `null` – brak zmian.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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)`

Ustawia właściwość obramowania (kolor lub styl) dla każdego kroku Range na liście zakresów. Prawidłowe wartości to true (włączone), false (wyłączone) i null (bez zmian). Kolor jest reprezentowany za pomocą notacji CSS, np. '#ffffff' lub 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`left`	`Boolean`	`true` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`bottom`	`Boolean`	`true` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`right`	`Boolean`	`true` oznacza obramowanie, `false` brak obramowania, `null` brak zmian.
`vertical`	`Boolean`	`true` – wewnętrzne pionowe obramowania, `false` – brak obramowania, `null` – brak zmian.
`horizontal`	`Boolean`	`true` – wewnętrzne poziome obramowania, `false` – brak obramowania, `null` – brak zmian.
`color`	`String`	Kolor obramowania w notacji CSS, np. `'#ffffff'` lub `'white'`, `null` dla koloru domyślnego (czarnego).
`style`	`BorderStyle`	Styl obramowania, `null` dla stylu domyślnego (ciągłego).

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 Range na liście zakresów. Kolor jest reprezentowany za pomocą notacji CSS, np. '#ffffff' lub 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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` zeruje kolor.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 Range na liście zakresów. Rodzina czcionek jest opisana za pomocą identyfikatora ciągu znaków, takiego jak Arial lub Roboto.

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

Parametry

Nazwa	Typ	Opis
`fontFamily`	`String`	Rodzina czcionek do ustawienia; wartość `null` zeruje rodzinę czcionek.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 Range na liście zakresów. Opcje stylów linii to 'underline', 'line-through' i 'none'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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` zeruje styl linii czcionki.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 Range na liście zakresów.

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

Parametry

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 Range na liście zakresów. Opcje stylu czcionki to 'italic' lub 'normal'.

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

Parametry

Nazwa	Typ	Opis
`fontStyle`	`String`	Styl czcionki: `'italic'` lub `'normal'`. Wartość `null` zresetuje styl czcionki.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 wagę czcionki dla każdego Range na liście zakresów. Opcje grubości czcionki to 'normal' lub 'bold'.

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

Parametry

Nazwa	Typ	Opis
`fontWeight`	`String`	Grubość czcionki: `'bold'` lub `'normal'`; wartość `null` zeruje grubość czcionki.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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)`

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

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

Parametry

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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)`

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

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 poziome dla każdego Range na liście zakresów. Opcje wyrównania to 'left', 'center' i 'right'.

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

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie: `'left'`, `'center'` lub `'normal'`; wartość `null` zeruje wyrównanie.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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` powoduje usunięcie notatki.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 liczby lub daty dla każdego elementu Range na liście zakresów.

Akceptowane wzorce formatowania opisane są w przewodniku po formatowaniu dat i liczb w interfejsie Sheets API.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 tekstowy formatu liczby.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 wyświetlić hiperlink.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 w każdym Range na liście zakresów. Jeśli kierunek null jest określony, jest on wywnioskowany, a następnie ustawiany.

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametry

Nazwa	Typ	Opis
`direction`	`TextDirection`	Pożądany kierunek tekstu; jeśli `null`, kierunek jest określany przed ustawieniem.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 obracania tekstu dla komórek w każdym Range na liście zakresów. Ten parametr odpowiada kątowi między standardową orientacją tekstu a pożądaną orientacją. Wartość 0 oznacza, że tekst ma standardową orientację.

W przypadku tekstu od lewej do prawej dodatnie nachylone kąty są skierowane przeciwnie do ruchu wskazówek zegara, a w przypadku tekstu od prawej do lewej – zgodnie z ruchem wskazówek zegara.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

Parametry

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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ść 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 „=”, jest interpretowany jako formuła.

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

Parametry

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 pionowe dla każdego Range na liście zakresów. Opcje wyrównania to 'top', 'middle' lub 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie: `'top'`, `'middle'` lub `'bottom'`; wartość `null` zeruje wyrównanie.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 tekst w komórkach dla każdego Range na liście zakresów ma być ułożony w stos. Jeśli tekst jest ułożony w wiele wierszy, ustawienie stopnia obrotu tekstu jest ignorowane.

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

Parametry

Nazwa	Typ	Opis
`isVertical`	`Boolean`	Określa, czy tekst ma być ułożony w strefach.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 wcięcie tekstu dla każdego elementu Range na liście zakresów. Komórki z włączoną opcją zawijania zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z wyłączonym przewijaniem wyświetlają jak najwięcej tekstu, nie zmieniając jego rozmiaru ani nie rozciągając go na kilka wierszy.

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

Parametry

Nazwa	Typ	Opis
`isWrapEnabled`	`Boolean`	Czy tekst ma być zawijany.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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ę przenoszenia tekstu dla każdego Range na liście zakresów.

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

Parametry

Nazwa	Typ	Opis
`strategy`	`WrapStrategy`	Wybrana strategia zawijania.

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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()`

Obcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce na liście zakresów. Usuwa wszystkie odstępy na początku i końcu tekstu w każdej komórce oraz zamienia pozostałe odstępy na pojedynczą spację.

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

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

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 „niezaznaczone”. Ignoruje komórki w zakresie, które nie zawierają skonfigurowanej wartości zaznaczenia lub niezaznaczenia.

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

Powrót

RangeList – ta lista zakresów do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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