Class RangeList

ZakresLista

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

MetodaZwracany typKrótki opis
activate()RangeListWybiera listę instancji Range.
breakApart()RangeListrozdzielenie wszystkich komórek scalonych poziomo lub pionowo zawartych w liście zakresów na pojedyncze komórki;
check()RangeListStan pól wyboru w zakresie zmieni się na „zaznaczone”.
clear()RangeListCzyści zakres treści, formatów i reguł sprawdzania danych dla każdego Range na liście zakresów.
clear(options)RangeListCzyści zakres treści, format, reguły sprawdzania poprawności danych i komentarze zgodnie z określonymi opcjami.
clearContent()RangeListCzyści zawartość każdego elementu Range na liście zakresów, nie zmieniając formatowania.
clearDataValidations()RangeListUsuwa reguły sprawdzania poprawności danych dla każdego Range na liście zakresów.
clearFormat()RangeListUsuwa formatowanie tekstu dla każdego Range na liście zakresów.
clearNote()RangeListCzyś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()RangeListWstawia pola wyboru w każdej komórce w zakresie, skonfigurowane za pomocą true dla zaznaczonych i false dla niezaznaczonych.
insertCheckboxes(checkedValue)RangeListWstawia 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)RangeListWstawia pola wyboru w każdej komórce zakresu, skonfigurowane z niestandardowymi wartościami dla zaznaczonych i niezaznaczonych stanów.
removeCheckboxes()RangeListusuwa wszystkie pola wyboru z zakresu.
setBackground(color)RangeListUstawia kolor tła dla każdego Range na liście zakresów.
setBackgroundRGB(red, green, blue)RangeListUstawia tło na podany kolor RGB.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListUstawia właściwość obramowania dla każdego elementu Range na liście zakresów.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListUstawia właściwość obramowania (kolor lub styl) dla każdego kroku Range na liście zakresów.
setFontColor(color)RangeListUstawia kolor czcionki dla każdego Range na liście zakresów.
setFontFamily(fontFamily)RangeListUstawia rodzinę czcionek dla każdego Range na liście zakresów.
setFontLine(fontLine)RangeListUstawia styl linii czcionki dla każdego Range na liście zakresów.
setFontSize(size)RangeListUstawia rozmiar czcionki (w punktach) dla każdego Range na liście zakresów.
setFontStyle(fontStyle)RangeListUstaw styl czcionki dla każdego Range na liście zakresów.
setFontWeight(fontWeight)RangeListUstaw wagę czcionki dla każdego Range na liście zakresów.
setFormula(formula)RangeListZaktualizuje formułę dla każdego Range na liście zakresów.
setFormulaR1C1(formula)RangeListZaktualizuje formułę dla każdego Range na liście zakresów.
setHorizontalAlignment(alignment)RangeListUstaw wyrównanie poziome dla każdego Range na liście zakresów.
setNote(note)RangeListUstawia tekst notatki dla każdego elementu Range na liście zakresów.
setNumberFormat(numberFormat)RangeListUstawia format liczby lub daty dla każdego elementu Range na liście zakresów.
setShowHyperlink(showHyperlink)RangeListOkreśla, czy każdy element Range na liście zakresów ma wyświetlać hiperlinki.
setTextDirection(direction)RangeListUstawia kierunek tekstu w komórkach w każdym Range na liście zakresów.
setTextRotation(degrees)RangeListUstawia ustawienia obracania tekstu dla komórek w każdym Range na liście zakresów.
setValue(value)RangeListUstawia wartość dla każdego elementu Range na liście zakresów.
setVerticalAlignment(alignment)RangeListUstaw wyrównanie pionowe dla każdego Range na liście zakresów.
setVerticalText(isVertical)RangeListOkreśla, czy tekst w komórkach dla każdego Range na liście zakresów ma być ułożony w stos.
setWrap(isWrapEnabled)RangeListUstaw łamanie wiersza dla każdego elementu Range na liście zakresów.
setWrapStrategy(strategy)RangeListUstawia strategię przenoszenia tekstu dla każdego Range na liście zakresów.
trimWhitespace()RangeListObcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce na liście zakresów.
uncheck()RangeListStan 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()

rozdzielenie wszystkich komórek scalonych poziomo lub pionowo zawartych 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 opcji 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ł sprawdzania 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

NazwaTypOpis
optionsObjectObiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
commentsOnlyBooleanOkreśla, czy usunąć tylko komentarze.
contentsOnlyBooleanOkreśla, czy ma zostać wyczyszczona tylko zawartość.
formatOnlyBooleanCzy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł sprawdzania poprawności danych.
validationsOnlyBooleanOkreśl, czy chcesz usunąć tylko reguły sprawdzania poprawności danych.
skipFilteredRowsBooleanOkreś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()

Usuwa 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

NazwaTypOpis
checkedValueObjectZaznaczona 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

NazwaTypOpis
checkedValueObjectZaznaczona wartość walidacji danych pola wyboru.
uncheckedValueObjectWartość 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

NazwaTypOpis
colorStringKod 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

NazwaTypOpis
redIntegerWartość czerwonego w notacji RGB.
greenIntegerWartość zielonego w notacji RGB.
blueIntegerWartość 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

NazwaTypOpis
topBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
leftBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
bottomBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
rightBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
verticalBooleantrue – wewnętrzne pionowe obramowania, false – brak obramowania, null – brak zmian.
horizontalBooleantrue – 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, na przykład '#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

NazwaTypOpis
topBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
leftBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
bottomBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
rightBooleantrue – obramowanie, false – brak obramowania, null – brak zmian.
verticalBooleantrue – wewnętrzne pionowe obramowania, false – brak obramowania, null – brak zmian.
horizontalBooleantrue – wewnętrzne poziome obramowania, false – brak obramowania, null – brak zmian.
colorStringKolor obramowania w notacji CSS, np. '#ffffff' lub 'white', null dla koloru domyślnego (czarnego).
styleBorderStyleStyl 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

NazwaTypOpis
colorStringKolor 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

NazwaTypOpis
fontFamilyStringRodzina 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

NazwaTypOpis
fontLineStringStyl 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

NazwaTypOpis
sizeIntegerRozmiar 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

NazwaTypOpis
fontStyleStringStyl 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

NazwaTypOpis
fontWeightStringGrubość 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

NazwaTypOpis
formulaStringCią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

NazwaTypOpis
formulaStringFormuł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

NazwaTypOpis
alignmentStringWyró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

NazwaTypOpis
noteStringTekst 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

NazwaTypOpis
numberFormatStringCią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

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

NazwaTypOpis
showHyperlinkBooleanOkreś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

NazwaTypOpis
directionTextDirectionPożą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 kierunku tekstu od lewej do prawej kąty dodatnie są skierowane przeciwnie do ruchu wskazówek zegara, a w przypadku kierunku 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

NazwaTypOpis
degreesIntegerPożą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

NazwaTypOpis
valueObjectWartość 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

NazwaTypOpis
alignmentStringWyró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

NazwaTypOpis
isVerticalBooleanOkreśla, czy tekst ma być ułożony w stosu.

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 łamanie wiersza 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 bez zmiany rozmiaru komórki ani rozciągania tekstu 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

NazwaTypOpis
isWrapEnabledBooleanCzy 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

NazwaTypOpis
strategyWrapStrategyWybrana 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ż

uncheck()

Zmienia stan pól wyboru w zakresie na „niezaznaczone”. Ignoruje komórki w zakresie, które nie zawierają skonfigurowanej wartości zaznaczenia ani 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