Class RangeList

ZakresLista

Zbiór co najmniej 1 Range instancji w tym samym arkuszu. Za pomocą tej klasy możesz wykonywać operacje na kolekcjach nieprzylegających zakresów lub komórek.

Metody

MetodaZwracany typKrótki opis
activate()RangeListWybiera listę instancji Range.
breakApart()RangeListRozdziela wszystkie komórki scalone poziomo lub pionowo w zakresie na pojedyncze komórki.
check()RangeListZmienia stan pól wyboru w zakresie na „zaznaczone”.
clear()RangeListCzyści zakres treści, formatów i reguł weryfikacji danych dla każdego Range na liście zakresów.
clear(options)RangeListCzyści zakres zawartości, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z podanymi opcjami.
clearContent()RangeListUsuwa zawartość każdego elementu Range na liście zakresów, pozostawiając formatowanie bez zmian.
clearDataValidations()RangeListUsuwa reguły sprawdzania poprawności danych dla każdego zakresu Range na liście zakresów.
clearFormat()RangeListUsuwa formatowanie tekstu dla każdego zakresu Range na liście zakresów.
clearNote()RangeListUsuwa notatkę dla każdego znaku Range na liście zakresów.
getRanges()Range[]Zwraca listę co najmniej 1 instancji Range w tym samym arkuszu.
insertCheckboxes()RangeListWstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z symbolem true dla zaznaczonego pola i false dla odznaczonego.
insertCheckboxes(checkedValue)RangeListWstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonych i pustym ciągiem znaków dla niezaznaczonych.
insertCheckboxes(checkedValue, uncheckedValue)RangeListWstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z wartościami niestandardowymi dla stanów zaznaczonego i niezaznaczonego.
removeCheckboxes()RangeListUsuwa wszystkie pola wyboru z zakresu.
setBackground(color)RangeListUstawia kolor tła każdego elementu 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 z kolorem lub stylem dla każdego elementu Range na liście zakresów.
setFontColor(color)RangeListUstawia kolor czcionki dla każdego znaku Range na liście zakresów.
setFontFamily(fontFamily)RangeListUstawia rodzinę czcionek dla każdego elementu Range na liście zakresów.
setFontLine(fontLine)RangeListUstawia styl linii czcionki dla każdego znaku Range na liście zakresów.
setFontSize(size)RangeListUstawia rozmiar czcionki (w punktach) dla każdego znaku Range na liście zakresów.
setFontStyle(fontStyle)RangeListUstaw styl czcionki dla każdego znaku Range na liście zakresów.
setFontWeight(fontWeight)RangeListUstaw wagę czcionki dla każdego symbolu Range na liście zakresów.
setFormula(formula)RangeListAktualizuje formułę dla każdego znaku Range na liście zakresów.
setFormulaR1C1(formula)RangeListAktualizuje formułę dla każdego znaku Range na liście zakresów.
setHorizontalAlignment(alignment)RangeListUstaw wyrównanie poziome dla każdego znaku 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 liczbowy lub format daty dla każdego znaku 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 obrotu tekstu dla komórek w każdym elemencie Range na liście zakresów.
setValue(value)RangeListUstawia wartość dla każdego symbolu Range na liście zakresów.
setVerticalAlignment(alignment)RangeListUstaw wyrównanie pionowe dla każdego elementu Range na liście zakresów.
setVerticalText(isVertical)RangeListOkreśla, czy tekst w komórkach ma być ułożony w stos dla każdego Range na liście zakresów.
setWrap(isWrapEnabled)RangeListUstaw zawijanie tekstu dla każdego elementu Range na liście zakresów.
setWrapStrategy(strategy)RangeListUstawia strategię zawijania tekstu dla każdego elementu Range na liście zakresów.
trimWhitespace()RangeListUsuwa białe znaki (np. spacje, tabulatory lub nowe wiersze) z każdej komórki na tej liście zakresów.
uncheck()RangeListZmienia stan pól wyboru w zakresie na „niezaznaczone”.

Szczegółowa dokumentacja

activate()

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

Uwaga: w ten sposób możesz wybrać wiele 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 łączenia.

Autoryzacja

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

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

breakApart()

Rozdziela wszystkie komórki scalone poziomo lub pionowo w zakresie na pojedyncze komórki.

Wywołanie tej funkcji na liście zakresów jest równoznaczne z wybraniem zestawu zakresów i kliknięciem elementu menu Arkuszy Format > Scal > Cofnij scalanie.

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

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 w zakresie na „zaznaczony”. Ignoruje komórki w zakresie, które nie zawierają obecnie skonfigurowanej wartości zaznaczonej lub 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 zawartości, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z podanymi 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 należy usunąć tylko komentarze.
contentsOnlyBooleanCzy wyczyścić tylko zawartość.
formatOnlyBooleanOkreśla, czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu powoduje też usunięcie reguł sprawdzania poprawności danych.
validationsOnlyBooleanOkreśla, czy należy usunąć tylko reguły sprawdzania poprawności danych.
skipFilteredRowsBooleanOkreśla, czy unikać czyszczenia odfiltrowanych wierszy.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 na liście zakresów, pozostawiając formatowanie bez zmian.

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

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 zakresu 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 łączenia.

Autoryzacja

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

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

clearFormat()

Usuwa formatowanie tekstu dla każdego zakresu Range na liście zakresów.

Spowoduje to usunięcie formatowania tekstu w każdym zakresie, ale nie zresetuje ż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 łączenia.

Autoryzacja

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

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

clearNote()

Usuwa notatkę dla każdego znaku 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 1 instancji Range w tym samym arkuszu.

Powrót

Range[] – lista zakresów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 z symbolem true dla zaznaczonego pola i false dla odznaczonego. 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonych i pustym ciągiem znaków dla niezaznaczonych. 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
checkedValueObjectWartość zaznaczonego pola wyboru w sprawdzaniu poprawności danych.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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, skonfigurowane z wartościami niestandardowymi dla stanów zaznaczonego i niezaznaczonego. Ustawia w każdej komórce w zakresie 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
checkedValueObjectWartość zaznaczonego pola wyboru w sprawdzaniu poprawności danych.
uncheckedValueObjectWartość niezaznaczonego pola wyboru w przypadku weryfikacji danych.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 sprawdzanie poprawności danych w każdej komórce, 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 reprezentowany 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 resetuje kolor.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 tło na podany kolor RGB. Jest to wygodna otoczka 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ść koloru zielonego w notacji RGB.
blueIntegerWartość koloru niebieskiego w notacji RGB.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (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, null – bez zmian.
leftBooleantrue – obramowanie, false – brak, null – bez zmian.
bottomBooleantrue – obramowanie, false – brak, null – bez zmian.
rightBooleantrue – obramowanie, false – brak, null – bez zmian.
verticalBooleantrue w przypadku wewnętrznych obramowań pionowych, false w przypadku braku obramowań, null w przypadku braku zmian.
horizontalBooleantrue w przypadku wewnętrznych obramowań poziomych, false w przypadku braku obramowań, null w przypadku braku zmian.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 z kolorem lub stylem 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). Kolor jest podany w 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

NazwaTypOpis
topBooleantrue – obramowanie, false – brak, null – bez zmian.
leftBooleantrue – obramowanie, false – brak, null – bez zmian.
bottomBooleantrue – obramowanie, false – brak, null – bez zmian.
rightBooleantrue – obramowanie, false – brak, null – bez zmian.
verticalBooleantrue w przypadku wewnętrznych obramowań pionowych, false w przypadku braku obramowań, null w przypadku braku zmian.
horizontalBooleantrue w przypadku wewnętrznych obramowań poziomych, false w przypadku braku obramowań, null w przypadku braku zmian.
colorStringKolor obramowania w notacji CSS, np. '#ffffff' lub 'white', null w przypadku koloru domyślnego (czarnego).
styleBorderStyleStyl obramowania, null w przypadku stylu domyślnego (ciągłego).

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 dla każdego znaku Range na liście zakresów. Kolor jest podany w 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 resetuje kolor.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 identyfikatorem w postaci ciągu znaków, np. 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 resetuje rodzinę czcionek.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 czcionki dla każdego znaku Range na liście zakresów. Opcje stylów linii to 'underline', 'line-through''none'.

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

Parametry

NazwaTypOpis
fontLineStringStyl linii czcionki, czyli 'underline', 'line-through' lub 'none'. Wartość null resetuje styl linii czcionki.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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) dla każdego znaku 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 dla każdego znaku 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 resetuje styl czcionki.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 symbolu Range na liście zakresów. Dostępne 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, czyli 'bold' lub 'normal'. Wartość null resetuje grubość czcionki.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 znaku Range na liście zakresów. Podana 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 znaków reprezentujący formułę do ustawienia.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 znaku 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 znaku Range na liście zakresów. Opcje wyrównania to 'left', 'center''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 resetuje wyrównanie.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 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 usuwa notatkę.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

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

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

setNumberFormat(numberFormat)

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

Akceptowane wzorce formatowania są opisane 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 znaków formatu liczbowego.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 hiperlink ma być widoczny.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 określony kierunek to null, kierunek jest 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
directionTextDirectionKierunek tekstu. Jeśli null, kierunek jest określany przed ustawieniem.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

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

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

setTextRotation(degrees)

Ustawia ustawienia obrotu tekstu dla komórek w każdym elemencie Range na liście zakresów. Wartość wejściowa odpowiada kątowi między standardową orientacją tekstu a pożądaną orientacją. Wartość 0 oznacza, że tekst jest ustawiony w orientacji standardowej.

W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są mierzone w kierunku przeciwnym do ruchu wskazówek zegara, a w przypadku kierunku od prawej do lewej – w kierunku zgodnym 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
degreesIntegerŻądany kąt między orientacją standardową a orientacją docelową. W przypadku tekstu od lewej do prawej dodatnie kąty są mierzone w kierunku przeciwnym do ruchu wskazówek zegara.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 symbolu 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 znaku „=”, 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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 pionowe dla każdego elementu 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 resetuje wyrównanie.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 w komórkach ma być ułożony w stos dla każdego Range na liście zakresu. Jeśli tekst jest ułożony pionowo, ustawienie obrotu tekstu w stopniach 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 stos.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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łączoną opcją zawijania zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z wyłączonym zawijaniem tekstu wyświetlają jak najwięcej tekstu bez zmiany rozmiaru i przechodzenia do wielu 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
isWrapEnabledBooleanOkreśla, czy zawijać tekst.

Powrót

RangeList – ta lista zakresów do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 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 łączenia.

Autoryzacja

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

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

trimWhitespace()

Usuwa białe znaki (np. spacje, tabulatory lub nowe wiersze) z każdej komórki na tej liście zakresów. Usuwa wszystkie odstępy na początku i na końcu tekstu w każdej komórce oraz redukuje każdą kolejną sekwencję pozostałych znaków odstępu do pojedynczej spacji.

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 łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 „odznaczone”. Ignoruje komórki w zakresie, które obecnie nie zawierają skonfigurowanej wartości zaznaczonej ani odznaczonej.

// 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 łączenia.

Autoryzacja

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

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