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
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
activate() | Range | Wybiera listę instancji Range. |
break | Range | Rozdziela wszystkie komórki scalone poziomo lub pionowo w zakresie na pojedyncze komórki. |
check() | Range | Zmienia stan pól wyboru w zakresie na „zaznaczone”. |
clear() | Range | Czyści zakres treści, formatów i reguł weryfikacji danych dla każdego Range na liście zakresów. |
clear(options) | Range | Czyści zakres zawartości, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z podanymi opcjami. |
clear | Range | Usuwa zawartość każdego elementu Range na liście zakresów, pozostawiając formatowanie bez zmian. |
clear | Range | Usuwa reguły sprawdzania poprawności danych dla każdego zakresu Range na liście zakresów. |
clear | Range | Usuwa formatowanie tekstu dla każdego zakresu Range na liście zakresów. |
clear | Range | Usuwa notatkę dla każdego znaku Range na liście zakresów. |
get | Range[] | Zwraca listę co najmniej 1 instancji Range w tym samym arkuszu. |
insert | Range | Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z symbolem true dla zaznaczonego pola i false dla odznaczonego. |
insert | Range | 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. |
insert | Range | Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z wartościami niestandardowymi dla stanów zaznaczonego i niezaznaczonego. |
remove | Range | Usuwa wszystkie pola wyboru z zakresu. |
set | Range | Ustawia kolor tła każdego elementu Range na liście zakresów. |
set | Range | Ustawia tło na podany kolor RGB. |
set | Range | Ustawia właściwość obramowania dla każdego elementu Range na liście zakresów. |
set | Range | Ustawia właściwość obramowania z kolorem lub stylem dla każdego elementu Range na liście zakresów. |
set | Range | Ustawia kolor czcionki dla każdego znaku Range na liście zakresów. |
set | Range | Ustawia rodzinę czcionek dla każdego elementu Range na liście zakresów. |
set | Range | Ustawia styl linii czcionki dla każdego znaku Range na liście zakresów. |
set | Range | Ustawia rozmiar czcionki (w punktach) dla każdego znaku Range na liście zakresów. |
set | Range | Ustaw styl czcionki dla każdego znaku Range na liście zakresów. |
set | Range | Ustaw wagę czcionki dla każdego symbolu Range na liście zakresów. |
set | Range | Aktualizuje formułę dla każdego znaku Range na liście zakresów. |
set | Range | Aktualizuje formułę dla każdego znaku Range na liście zakresów. |
set | Range | Ustaw wyrównanie poziome dla każdego znaku Range na liście zakresów. |
set | Range | Ustawia tekst notatki dla każdego elementu Range na liście zakresów. |
set | Range | Ustawia format liczbowy lub format daty dla każdego znaku Range na liście zakresów. |
set | Range | Określa, czy każdy element Range na liście zakresów ma wyświetlać hiperlinki. |
set | Range | Ustawia kierunek tekstu w komórkach w każdym Range na liście zakresów. |
set | Range | Ustawia ustawienia obrotu tekstu dla komórek w każdym elemencie Range na liście zakresów. |
set | Range | Ustawia wartość dla każdego symbolu Range na liście zakresów. |
set | Range | Ustaw wyrównanie pionowe dla każdego elementu Range na liście zakresów. |
set | Range | Określa, czy tekst w komórkach ma być ułożony w stos dla każdego Range na liście zakresów. |
set | Range | Ustaw zawijanie tekstu dla każdego elementu Range na liście zakresów. |
set | Range | Ustawia strategię zawijania tekstu dla każdego elementu Range na liście zakresów. |
trim | Range | Usuwa białe znaki (np. spacje, tabulatory lub nowe wiersze) z każdej komórki na tej liście zakresów. |
uncheck() | Range | Zmienia 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
Range – 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
break Apart()
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
Range – 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
Range – 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
Range – 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
| Nazwa | Typ | Opis |
|---|---|---|
options | Object | Obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej. |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
comments | Boolean | Określa, czy należy usunąć tylko komentarze. |
contents | Boolean | Czy wyczyścić tylko zawartość. |
format | Boolean | Określa, czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu powoduje też usunięcie reguł sprawdzania poprawności danych. |
validations | Boolean | Określa, czy należy usunąć tylko reguły sprawdzania poprawności danych. |
skip | Boolean | Określa, czy unikać czyszczenia odfiltrowanych wierszy. |
Powrót
Range – 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 Content()
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
Range – 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 Data Validations()
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
Range – 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 Format()
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
Range – 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 Note()
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
Range – 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
get Ranges()
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
insert Checkboxes()
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
Range – 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
insert Checkboxes(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
| Nazwa | Typ | Opis |
|---|---|---|
checked | Object | Wartość zaznaczonego pola wyboru w sprawdzaniu poprawności danych. |
Powrót
Range – 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
insert Checkboxes(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
| Nazwa | Typ | Opis |
|---|---|---|
checked | Object | Wartość zaznaczonego pola wyboru w sprawdzaniu poprawności danych. |
unchecked | Object | Wartość niezaznaczonego pola wyboru w przypadku weryfikacji danych. |
Powrót
Range – 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
remove Checkboxes()
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
Range – 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
set Background(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
| Nazwa | Typ | Opis |
|---|---|---|
color | String | Kod koloru tła w notacji CSS, np. '#ffffff' lub 'white'; wartość null resetuje kolor. |
Powrót
Range – 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
set Background RGB(red, green, blue)
Ustawia tło na podany kolor RGB. Jest to wygodna otoczka wywołania set.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); // Sets the background to red for each range in the range list. rangeList.setBackgroundRGB(255, 0, 0);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
red | Integer | Wartość czerwonego w notacji RGB. |
green | Integer | Wartość koloru zielonego w notacji RGB. |
blue | Integer | Wartość koloru niebieskiego w notacji RGB. |
Powrót
Range – 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
set Border(top, left, bottom, right, vertical, horizontal)
Ustawia właściwość obramowania dla każdego elementu Range na liście zakresów. Prawidłowe wartości to true (włączone), false (wyłączone) i null (bez zmian).
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves // the left and right unchanged. rangeList.setBorder(true, null, true, null, false, false);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
top | Boolean | true – obramowanie, false – brak, null – bez zmian. |
left | Boolean | true – obramowanie, false – brak, null – bez zmian. |
bottom | Boolean | true – obramowanie, false – brak, null – bez zmian. |
right | Boolean | true – obramowanie, false – brak, null – bez zmian. |
vertical | Boolean | true w przypadku wewnętrznych obramowań pionowych, false w przypadku braku obramowań, null w przypadku braku zmian. |
horizontal | Boolean | true w przypadku wewnętrznych obramowań poziomych, false w przypadku braku obramowań, null w przypadku braku zmian. |
Powrót
Range – 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
set Border(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
| Nazwa | Typ | Opis |
|---|---|---|
top | Boolean | true – obramowanie, false – brak, null – bez zmian. |
left | Boolean | true – obramowanie, false – brak, null – bez zmian. |
bottom | Boolean | true – obramowanie, false – brak, null – bez zmian. |
right | Boolean | true – obramowanie, false – brak, null – bez zmian. |
vertical | Boolean | true w przypadku wewnętrznych obramowań pionowych, false w przypadku braku obramowań, null w przypadku braku zmian. |
horizontal | Boolean | true w przypadku wewnętrznych obramowań poziomych, false w przypadku braku obramowań, null w przypadku braku zmian. |
color | String | Kolor obramowania w notacji CSS, np. '#ffffff' lub 'white', null w przypadku koloru domyślnego (czarnego). |
style | Border | Styl obramowania, null w przypadku stylu domyślnego (ciągłego). |
Powrót
Range – 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
set Font Color(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
| Nazwa | Typ | Opis |
|---|---|---|
color | String | Kolor czcionki w notacji CSS, np. '#ffffff' lub 'white'; wartość null resetuje kolor. |
Powrót
Range – 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
set Font Family(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
| Nazwa | Typ | Opis |
|---|---|---|
font | String | Rodzina czcionek do ustawienia. Wartość null resetuje rodzinę czcionek. |
Powrót
Range – 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
set Font Line(fontLine)
Ustawia styl linii czcionki dla każdego znaku Range na liście zakresów. Opcje stylów linii to 'underline', 'line-through' i 'none'.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
font | String | Styl linii czcionki, czyli 'underline', 'line-through' lub 'none'. Wartość null resetuje styl linii czcionki. |
Powrót
Range – 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
set Font Size(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
| Nazwa | Typ | Opis |
|---|---|---|
size | Integer | Rozmiar czcionki w punktach. |
Powrót
Range – 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
set Font Style(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
| Nazwa | Typ | Opis |
|---|---|---|
font | String | Styl czcionki, 'italic' lub 'normal'; wartość null
resetuje styl czcionki. |
Powrót
Range – 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
set Font Weight(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
| Nazwa | Typ | Opis |
|---|---|---|
font | String | Grubość czcionki, czyli 'bold' lub 'normal'. Wartość null
resetuje grubość czcionki. |
Powrót
Range – 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
set Formula(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
| Nazwa | Typ | Opis |
|---|---|---|
formula | String | Ciąg znaków reprezentujący formułę do ustawienia. |
Powrót
Range – 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
set Formula R1C1(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
| Nazwa | Typ | Opis |
|---|---|---|
formula | String | Formuła tekstowa. |
Powrót
Range – 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
set Horizontal Alignment(alignment)
Ustaw wyrównanie poziome dla każdego znaku Range na liście zakresów. Opcje wyrównania to 'left', 'center' i 'right'.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setHorizontalAlignment('center');
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
alignment | String | Wyrównanie: 'left', 'center' lub 'normal'. Wartość null resetuje wyrównanie. |
Powrót
Range – 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
set Note(note)
Ustawia tekst notatki dla każdego elementu Range na liście zakresów.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setNote('This is a note');
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
note | String | Tekst notatki do ustawienia. Wartość null usuwa notatkę. |
Powrót
Range – 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
set Number Format(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
| Nazwa | Typ | Opis |
|---|---|---|
number | String | Ciąg znaków formatu liczbowego. |
Powrót
Range – 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
set Show Hyperlink(showHyperlink)
Określa, czy każdy element Range na liście zakresów ma wyświetlać hiperlinki.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Show hyperlinks for all the ranges. rangeList.setShowHyperlink(true);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
show | Boolean | Określa, czy hiperlink ma być widoczny. |
Powrót
Range – 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
set Text Direction(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
| Nazwa | Typ | Opis |
|---|---|---|
direction | Text | Kierunek tekstu. Jeśli null, kierunek jest określany przed ustawieniem. |
Powrót
Range – 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
set Text Rotation(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
| Nazwa | Typ | Opis |
|---|---|---|
degrees | Integer | Żą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
Range – 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
set Value(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
| Nazwa | Typ | Opis |
|---|---|---|
value | Object | Wartość zakresu. |
Powrót
Range – 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
set Vertical Alignment(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
| Nazwa | Typ | Opis |
|---|---|---|
alignment | String | Wyrównanie: 'top', 'middle' lub 'bottom'. Wartość null resetuje wyrównanie. |
Powrót
Range – 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
set Vertical Text(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
| Nazwa | Typ | Opis |
|---|---|---|
is | Boolean | Określa, czy tekst ma być ułożony w stos. |
Powrót
Range – 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
set Wrap(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
| Nazwa | Typ | Opis |
|---|---|---|
is | Boolean | Określa, czy zawijać tekst. |
Powrót
Range – 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
set Wrap Strategy(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
| Nazwa | Typ | Opis |
|---|---|---|
strategy | Wrap | Wybrana strategia zawijania. |
Powrót
Range – 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
trim Whitespace()
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
Range – 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
Range – 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