Class RangeList

RangeList

Kolekcja zawierająca co najmniej 1 instancję Range w tym samym arkuszu. Możesz korzystać z tych zajęć możesz wykonać operacje na zbiorach komórek lub zakresów, które do siebie nie przylegają.

Metody

MetodaZwracany typKrótki opis
activate()RangeListWybiera listę Range instancji.
breakApart()RangeListPodziel wszystkie komórki scalone w poziomie lub w pionie zawarte na liście zakresów na z poszczególnych komórek.
check()RangeListZmienia stan pól wyboru w zakresie na „zaznaczone”.
clear()RangeListUsuwa zakres treści, formatów i reguł weryfikacji danych w przypadku każdego elementu Range w listę zakresów.
clear(options)RangeListCzyści zakres treści, formatu, reguł sprawdzania poprawności danych i komentarze zgodnie z parametrem podanych opcji.
clearContent()RangeListUsuwa zawartość poszczególnych elementów Range na liście zakresów, pozostawiając formatowanie bez zmian.
clearDataValidations()RangeListUsuwa reguły sprawdzania poprawności danych dla każdego elementu Range na liście zakresów.
clearFormat()RangeListUsuwa formatowanie tekstu dla każdego elementu Range na liście zakresów.
clearNote()RangeListUsuwa notatkę dla każdego elementu 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, przy czym zaznaczono przy użyciu true false (pole niezaznaczone).
insertCheckboxes(checkedValue)RangeListWstawia pola wyboru do każdej komórki w zakresie, skonfigurowaną za pomocą niestandardowej wartości dla zaznaczonych i pusty ciąg znaków dla niezaznaczonego.
insertCheckboxes(checkedValue, uncheckedValue)RangeListWstawia pola wyboru do każdej komórki w zakresie, skonfigurowane za pomocą niestandardowych wartości zaznaczonych i stany niezaznaczone.
removeCheckboxes()RangeListUsuwa wszystkie pola wyboru z zakresu.
setBackground(color)RangeListOkreśla kolor tła każdego elementu typu Range na liście zakresów.
setBackgroundRGB(red, green, blue)RangeListUstawia tło na dany 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)RangeListOkreśla właściwość obramowania z kolorem lub stylem dla każdego elementu Range na liście zakresów.
setFontColor(color)RangeListOkreśla kolor czcionki każdego elementu Range na liście zakresów.
setFontFamily(fontFamily)RangeListOkreśla rodzinę czcionek dla każdego elementu typu Range na liście zakresów.
setFontLine(fontLine)RangeListUstawia styl linii czcionki dla każdego elementu Range na liście zakresów.
setFontSize(size)RangeListUstawia rozmiar czcionki (w punktach) dla każdego elementu typu Range na liście zakresów.
setFontStyle(fontStyle)RangeListUstaw styl czcionki dla każdego elementu Range na liście zakresów.
setFontWeight(fontWeight)RangeListUstaw grubość czcionki dla każdego elementu Range na liście zakresów.
setFormula(formula)RangeListAktualizuje formułę każdego pola Range na liście zakresów.
setFormulaR1C1(formula)RangeListAktualizuje formułę każdego pola Range na liście zakresów.
setHorizontalAlignment(alignment)RangeListUstaw wyrównanie w poziomie dla każdego elementu Range na liście zakresów.
setNote(note)RangeListUstawia tekst notatki dla każdego elementu Range na liście zakresów.
setNumberFormat(numberFormat)RangeListOkreśla format liczb 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)RangeListOkreśla kierunek tekstu w komórkach w komórkach zakresu Range na liście zakresów.
setTextRotation(degrees)RangeListOkreśla ustawienia rotacji tekstu dla komórek w poszczególnych komórkach Range na liście zakresów.
setValue(value)RangeListOkreśla wartość każdego pola Range na liście zakresów.
setVerticalAlignment(alignment)RangeListUstaw wyrównanie w pionie dla każdego elementu Range na liście zakresów.
setVerticalText(isVertical)RangeListOkreśla, czy tekst w komórkach z każdego elementu Range w zakresie ma być nakładany z listy.
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()RangeListPowoduje usunięcie spacji (np. spacji, tabulatorów lub nowych wierszy) we wszystkich komórkach na liście zakresów.
uncheck()RangeListZmienia stan pól wyboru w zakresie na „niezaznaczone”.

Szczegółowa dokumentacja

activate()

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

Uwaga: w ten sposób możesz wybrać wiele 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();

Powrót

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

Autoryzacja

Skrypty korzystające 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()

Podziel wszystkie komórki scalone w poziomie lub w pionie zawarte na liście zakresów na z poszczególnych komórek.

Wywołanie tej funkcji na liście zakresów jest równoważne wybraniu zbioru zakresów i wybierając format Format > Scal > Rozdziel pozycję menu Arkuszy.

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

Powrót

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

Autoryzacja

Skrypty korzystające 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”. Ignoruje komórki w zakresie , które obecnie nie zawierają ani 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Powrót

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

Autoryzacja

Skrypty korzystające 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()

Usuwa zakres treści, formatów i reguł weryfikacji danych w przypadku każdego elementu Range w listę zakresów.

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

Powrót

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

Autoryzacja

Skrypty korzystające 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, formatu, reguł sprawdzania poprawności danych i komentarze zgodnie z parametrem podanych opcji. 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parametry

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

Parametry zaawansowane

NazwaTypOpis
commentsOnlyBooleanOkreśla, czy usunąć tylko komentarze.
contentsOnlyBooleanOkreśla, czy wyczyścić tylko zawartość.
formatOnlyBooleanOkreśla, czy wyczyścić tylko format; pamiętaj, że usunięcie usuwa też reguły sprawdzania poprawności danych.
validationsOnlyBooleanOkreśla, czy usuwać tylko reguły sprawdzania poprawności danych.
skipFilteredRowsBooleanOkreśla, czy unikać czyszczenia odfiltrowanych wierszy.

Powrót

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

Autoryzacja

Skrypty korzystające 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()

Usuwa zawartość poszczególnych elementów Range na liście zakresów, pozostawiając formatowanie bez zmian.

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

Powrót

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

Autoryzacja

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

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

Powrót

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

Autoryzacja

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

Spowoduje to wyczyszczenie formatowania tekstu w każdym zakresie. Nie spowoduje to zresetowania żadnych reguł formatowania liczb.

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

Powrót

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

Autoryzacja

Skrypty korzystające 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()

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

Powrót

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

Autoryzacja

Skrypty korzystające 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 instancji Range w tym samym arkuszu.

Powrót

Range[] – lista zakresów.

Autoryzacja

Skrypty korzystające 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 do każdej komórki w zakresie, przy czym zaznaczono przy użyciu true false (pole niezaznaczone). 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();

Powrót

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

Autoryzacja

Skrypty korzystające 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, skonfigurowaną za pomocą niestandardowej wartości dla zaznaczonych i puste pole do niezaznaczenia. Ustawia pustą 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
checkedValueObjectZaznaczona wartość pola sprawdzania poprawności danych.

Powrót

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

Autoryzacja

Skrypty korzystające 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 do każdej komórki w zakresie, przy czym skonfigurowane wartości niestandardowe dla zaznaczonych komórek i stany niezaznaczone. Ustawia wartość w każdej komórce zakresu na niestandardową, niezaznaczoną 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
checkedValueObjectZaznaczona wartość pola sprawdzania poprawności danych.
uncheckedValueObjectNiezaznaczona wartość pola wyboru sprawdzania poprawności danych.

Powrót

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

Autoryzacja

Skrypty korzystające 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 każdej komórki oraz dodatkowo usuwa wartość, jeśli komórka zawiera wartość zaznaczoną lub niezaznaczoną.

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

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa kolor tła każdego elementu typu Range na liście zakresów. Kolor jest reprezentowany w 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 powoduje zresetowanie koloru.

Powrót

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

Autoryzacja

Skrypty korzystające 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 dany kolor RGB. Jest to udogodnienie powiązane z wywołaniem 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.
blueIntegerWartość niebieska w notacji RGB.

Powrót

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

Autoryzacja

Skrypty korzystające 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ł.), 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 – 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 – wewnętrzne obramowanie pionowe, false – brak, null – bez zmian.
horizontalBooleantrue – wewnętrzne poziome obramowanie, false – brak, null – bez zmian.

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa 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ł.), false (wyłączony) i null (bez zmian). Obecny kolor to reprezentowane 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 – 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 – wewnętrzne obramowanie pionowe, false – brak, null – bez zmian.
horizontalBooleantrue – wewnętrzne poziome obramowanie, false – brak, null – bez zmian.
colorStringKolor obramowania w notacji CSS, np. '#ffffff' lub 'white', null w przypadku koloru domyślnego (czarny).
styleBorderStyleStyl obramowania, null – styl domyślny (ciągły).

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa kolor czcionki każdego elementu Range na liście zakresów. Kolor jest reprezentowany w CSS zapis; 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'; w Wartość null resetuje kolor.

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa rodzinę czcionek dla każdego elementu typu Range na liście zakresów. Rodzina czcionek została opisana. za pomocą identyfikatora ciągu znaków, 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.

Powrót

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

Autoryzacja

Skrypty korzystające 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 elementu Range na liście zakresów. Opcje stylów 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 linii czcionki.

Powrót

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

Autoryzacja

Skrypty korzystające 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 elementu typu Range na liście zakresów.

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

Parametry

NazwaTypOpis
sizeIntegerrozmiar punktu czcionki.

Powrót

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

Autoryzacja

Skrypty korzystające 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 elementu Range na liście zakresów. Dostępne są następujące opcje stylu czcionki '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'); null resetuje styl czcionki.

Powrót

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

Autoryzacja

Skrypty korzystające 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 grubość czcionki dla każdego elementu Range na liście zakresów. Dostępne są następujące grubości czcionki 'normal' lub 'bold'.

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

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Aktualizuje formułę każdego pola Range na liście zakresów. Podana formuła musi znajdować się w argumencie Zapis 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.

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Aktualizuje formułę każdego pola Range na liście zakresów. Podana formuła musi znajdować się w argumencie 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 znaków.

Powrót

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

Autoryzacja

Skrypty korzystające 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 w poziomie dla każdego elementu Range na liście zakresów. 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'; w Wartość null resetuje wyrównanie.

Powrót

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

Autoryzacja

Skrypty korzystające 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.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 – lista zakresów do tworzenia łańcuchów.

Autoryzacja

Skrypty korzystające 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)

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

Akceptowane wzorce formatowania opisano w przewodniku po formatowaniu dat i liczb w interfejsie Arkuszy API.

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

Powrót

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

Autoryzacja

Skrypty korzystające 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.

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 ma być wyświetlany hiperlink.

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa kierunek tekstu w komórkach w poszczególnych komórkach Range na liście zakresów. Jeśli w podanym kierunku to null, kierunek jest ustalany i ustawiany.

// 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
directionTextDirectionżądany kierunek tekstu; jeśli null, kierunek jest ustalany wcześniej .

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa ustawienia rotacji tekstu dla komórek w poszczególnych komórkach Range na liście zakresów. odpowiada kątowi między standardową orientacją tekstu a orientacji ekranu. Wartość 0 oznacza, że tekst jest ustawiony w orientacji standardowej.

W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są w kierunku przeciwnym do ruchu wskazówek zegara, a od prawej do lewej – w kierunku ruchu wskazówek zegara.

// 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 orientacją standardową a żądaną orientacją. W przypadku tekstu od lewej do prawej kąty dodatnie są zapisane w kierunku przeciwnym do ruchu wskazówek zegara.

Powrót

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

Autoryzacja

Skrypty korzystające 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)

Określa wartość każdego pola Range na liście zakresów. Wartością może być liczba, ciąg, wartość logiczna lub data. Jeśli zaczyna się od „=” interpretowany jest jako wzór.

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.

Powrót

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

Autoryzacja

Skrypty korzystające 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 w pionie 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające 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 z każdego elementu Range w zakresie ma być nakładany z listy. Jeśli tekst jest ułożony pionowo, ustawienie stopni obrotu tekstu jest ignorowane.

// 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ć nakładany na stos.

Powrót

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

Autoryzacja

Skrypty korzystające 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 zawijanie tekstu dla każdego elementu Range na liście zakresów. Zmiana rozmiaru komórek z włączonym zawijaniem wyświetlając ich pełną treść. Komórki z wyłączonym zawijaniem wyświetlają się w miarę możliwości bez zmiany rozmiaru i wyświetlania w kilku liniach.

// 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 tekst ma być zawijany.

Powrót

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

Autoryzacja

Skrypty korzystające 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ę zawijania tekstu dla każdego elementu Range na liście zakresów.

// 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
strategyWrapStrategyPożądana strategia opakowań.

Powrót

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

Autoryzacja

Skrypty korzystające 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()

Powoduje usunięcie spacji (np. spacji, tabulatorów lub nowych wierszy) we wszystkich komórkach na liście zakresów. Usuwa wszystkie spacje z początku i końca tekstu każdej komórki oraz zmniejsza kolejne podsekwencje pozostałych znaków odstępu na pojedynczą spację.

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

Powrót

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

Autoryzacja

Skrypty korzystające 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 obecnie nie zawierają ani 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 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Powrót

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

Autoryzacja

Skrypty korzystające 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