Class RangeList

Lista zakresów

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

Metody

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

Szczegółowa dokumentacja

activate()

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

Uwaga: umożliwia to zaznaczenie wielu zakresów.

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

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

Zwróć

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

Autoryzacja

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

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

breakApart()

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

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

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

Zwróć

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

Autoryzacja

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

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

check()

Zmienia stan pól wyboru na „zaznaczone”. Ignoruje komórki z zakresu, który obecnie nie zawiera żadnej zaznaczonej lub nieskonfigurowanej wartości.

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

Zwróć

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

Autoryzacja

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

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

clear()

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

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

Zwróć

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

Autoryzacja

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

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

clear(options)

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

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parametry

NazwaTypOpis
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
commentsOnlyBooleanCzy usunąć tylko komentarze
contentsOnlyBooleanOkreśla, czy chcesz usunąć tylko zawartość.
formatOnlyBooleanCzy usunąć tylko format – pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł weryfikacji danych.
validationsOnlyBooleanOkreśla, czy usunąć tylko reguły weryfikacji danych.
skipFilteredRowsBooleanOkreśla, czy uniknąć czyszczenia odfiltrowanych wierszy.

Zwróć

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

Autoryzacja

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

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

clearContent()

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

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

Zwróć

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

Autoryzacja

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

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

clearDataValidations()

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

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

Zwróć

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

Autoryzacja

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

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

clearFormat()

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

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

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

Zwróć

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

Autoryzacja

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

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

clearNote()

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

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

Zwróć

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

Autoryzacja

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

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

getRanges()

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

Zwróć

Range[] – lista zakresów,

Autoryzacja

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

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

insertCheckboxes()

Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane za pomocą zasady true jako zaznaczone i false do odznaczenia. Ustawia wartość wszystkich komórek w zakresie na false.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

Zwróć

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

Autoryzacja

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

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

insertCheckboxes(checkedValue)

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

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

Parametry

NazwaTypOpis
checkedValueObjectSprawdzana wartość sprawdzania poprawności danych pola wyboru.

Zwróć

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

Autoryzacja

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

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

insertCheckboxes(checkedValue, uncheckedValue)

Wstawia pola wyboru do każdej komórki w zakresie wraz z wartościami niestandardowymi dla stanów zaznaczenia i odznaczonych. Ustawia wartość każdej komórki w zakresie na niestandardową odznaczoną wartość.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

Parametry

NazwaTypOpis
checkedValueObjectSprawdzana wartość sprawdzania poprawności danych pola wyboru.
uncheckedValueObjectNiezaznaczona wartość do weryfikacji danych pola wyboru.

Zwróć

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

Autoryzacja

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

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

removeCheckboxes()

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

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

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

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

Zwróć

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

Autoryzacja

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

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

setBackground(color)

Ustawia kolor tła każdego elementu (Range) na liście zakresów. Kolor jest wyrażony w notacji CSS, na przykład '#ffffff' lub 'white'.

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

Parametry

NazwaTypOpis
colorStringKod koloru tła w notacji CSS, np. '#ffffff' lub 'white'. Wartość null resetuje kolor.

Zwróć

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

Autoryzacja

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

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

setBackgroundRGB(red, green, blue)

Ustawia kolor tła na określony kolor RGB. To wygodny komunikat dotyczący wywołania setBackground(color).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

Parametry

NazwaTypOpis
redIntegerWartość czerwona w notacji RGB.
greenIntegerZielona wartość w notacji RGB.
blueIntegerNiebieska wartość w notacji RGB.

Zwróć

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

Autoryzacja

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

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

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

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

Parametry

NazwaTypOpis
topBooleantrue dla obramowania, false – brak, null bez zmian.
leftBooleantrue dla obramowania, false – brak, null bez zmian.
bottomBooleantrue dla obramowania, false – brak, null bez zmian.
rightBooleantrue dla obramowania, false – brak, null bez zmian.
verticalBooleantrue – obramowanie wewnętrzne, false – brak, null – bez zmian.
horizontalBooleantrue – obramowanie wewnętrzne w poziomie, false – brak, null – bez zmian.

Zwróć

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

Autoryzacja

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

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

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

Ustawia właściwość obramowania dla koloru lub stylu dla każdego elementu Range na liście zakresów. Prawidłowe wartości to true (on), false (wyłączony) i null (bez zmian). Kolor jest podany w notacji CSS, na przykład '#ffffff' lub 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

Parametry

NazwaTypOpis
topBooleantrue dla obramowania, false – brak, null bez zmian.
leftBooleantrue dla obramowania, false – brak, null bez zmian.
bottomBooleantrue dla obramowania, false – brak, null bez zmian.
rightBooleantrue dla obramowania, false – brak, null bez zmian.
verticalBooleantrue – obramowanie wewnętrzne, false – brak, null – bez zmian.
horizontalBooleantrue – obramowanie wewnętrzne w poziomie, false – brak, null – bez zmian.
colorStringKolor obramowania w notacji CSS, np. '#ffffff' lub 'white', null, aby zmienić kolor domyślny (czarny).
styleBorderStyleStyl obramowań, null – styl domyślny (ciągły).

Zwróć

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

Autoryzacja

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

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

setFontColor(color)

Ustawia kolor czcionki w przypadku każdego elementu Range z listy. Kolor jest podany w notacji CSS, na przykład '#ffffff' lub 'white'.

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

Parametry

NazwaTypOpis
colorStringKolor czcionki w notacji CSS, np. '#ffffff' lub 'white', wartość null resetuje kolor.

Zwróć

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

Autoryzacja

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

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

setFontFamily(fontFamily)

Ustawia rodzinę czcionek dla każdego elementu Range na liście zakresów. Rodzina czcionek jest opisana za pomocą identyfikatora ciągu, takiego jak Arial lub Roboto.

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

Parametry

NazwaTypOpis
fontFamilyStringRodzina czcionek do ustawienia – wartość null resetuje rodzinę czcionek.

Zwróć

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

Autoryzacja

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

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

setFontLine(fontLine)

Ustawia styl linii czcionek w każdym polu Range z listy. Opcje stylu linii to 'underline', 'line-through' lub 'none'.

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

Parametry

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

Zwróć

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

Autoryzacja

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

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

setFontSize(size)

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

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

Parametry

NazwaTypOpis
sizeIntegerRozmiar punktu czcionki.

Zwróć

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

Autoryzacja

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

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

setFontStyle(fontStyle)

Ustaw styl czcionki w przypadku każdego elementu Range z listy. Dostępne typy czcionek to 'italic' lub 'normal'.

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

Parametry

NazwaTypOpis
fontStyleStringStyl czcionki ('italic' lub 'normal'); wartość null resetuje styl czcionki.

Zwróć

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

Autoryzacja

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

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

setFontWeight(fontWeight)

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

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

Parametry

NazwaTypOpis
fontWeightStringWaga czcionki: 'bold' lub 'normal'; wartość null resetuje grubość czcionki.

Zwróć

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

Autoryzacja

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

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

setFormula(formula)

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

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

Parametry

NazwaTypOpis
formulaStringCiąg znaków reprezentujący formułę do ustawienia.

Zwróć

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

Autoryzacja

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

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

setFormulaR1C1(formula)

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parametry

NazwaTypOpis
formulaStringFormuła ciągu.

Zwróć

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

Autoryzacja

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

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

setHorizontalAlignment(alignment)

Wyrównaj w poziomie dla każdego elementu Range z listy zakresów. Dostępne opcje wyrównania to 'left', 'center' lub 'right'.

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

Parametry

NazwaTypOpis
alignmentStringWyrównanie 'left', 'center' lub 'normal'; wartość null resetuje wyrównanie.

Zwróć

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

Autoryzacja

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

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

setNote(note)

Ustawia tekst notatki dla każdego wymiaru Range z listy.

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

Parametry

NazwaTypOpis
noteStringTekst notatki, który chcesz ustawić; usunięcie wartości null spowoduje usunięcie notatki.

Zwróć

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

Autoryzacja

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

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

setNumberFormat(numberFormat)

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

Akceptowane wzorce formatowania znajdziesz w przewodniku po formatowaniu daty i liczby w interfejsie API Arkuszy.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Parametry

NazwaTypOpis
numberFormatStringCiąg w formacie liczb.

Zwróć

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

Autoryzacja

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

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

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

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

Parametry

NazwaTypOpis
showHyperlinkBooleanOkreśla, czy hiperlink ma być wyświetlany.

Zwróć

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

Autoryzacja

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

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

setTextDirection(direction)

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

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

Parametry

NazwaTypOpis
directionTextDirectionOczekiwany kierunek tekstu. Jeśli null jest określony, przed ustawieniem.

Zwróć

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

Autoryzacja

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

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

setTextRotation(degrees)

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

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

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

Parametry

NazwaTypOpis
degreesIntegerŻądany kąt między standardową a żądaną orientacją. W przypadku tekstu od lewej do prawej dodatnie kąty są ustawione w lewo.

Zwróć

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

Autoryzacja

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

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

setValue(value)

Ustawia wartość dla każdego elementu Range na liście zakresów. Wartość może być liczbą, ciągiem znaków, wartością logiczną lub datą. Jeśli zaczyna się od ciągu '=&#39, jest interpretowany jako formuła.

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

Parametry

NazwaTypOpis
valueObjectWartość zakresu.

Zwróć

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

Autoryzacja

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

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

setVerticalAlignment(alignment)

Ustaw wyrównanie w pionie do każdego elementu Range na liście zakresów. Dostępne opcje wyrównania to 'top', 'middle' lub 'bottom'.

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

Parametry

NazwaTypOpis
alignmentStringWyrównanie 'top', 'middle' lub 'bottom'; wartość null resetuje wyrównanie.

Zwróć

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

Autoryzacja

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

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

setVerticalText(isVertical)

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

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

Parametry

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

Zwróć

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

Autoryzacja

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

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

setWrap(isWrapEnabled)

Ustaw zawijanie tekstu dla każdego elementu Range na liście zakresów. Komórki z włączonym rozmiarem zawijania wyświetlają pełną treść. Komórki z wyłączonym zawijaniem wyświetlają jak najwięcej reklam bez zmiany rozmiaru lub wyświetlania w wielu wierszach.

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

Parametry

NazwaTypOpis
isWrapEnabledBooleanOkreśla, czy zawijać tekst, czy nie.

Zwróć

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

Autoryzacja

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

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

setWrapStrategy(strategy)

Ustawia strategię zawijania tekstu dla każdego elementu Range z listy.

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

Parametry

NazwaTypOpis
strategyWrapStrategyŻądana strategia dodawania kodów.

Zwróć

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

Autoryzacja

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

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

trimWhitespace()

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

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

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

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

Zwróć

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

Autoryzacja

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

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

Zobacz też


uncheck()

Zmienia stan pól wyboru na „Niezaznaczone”. Ignoruje komórki z zakresu, który obecnie nie zawiera żadnej zaznaczonej lub nieskonfigurowanej wartości.

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

Zwróć

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

Autoryzacja

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

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