Zbiór co najmniej 1 instancji Range
na tym samym arkuszu. Z tej klasy możesz korzystać, aby stosować operacje na zbiorach niesąsiadujących zakresów lub komórek.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
activate() | Range | Wybiera listę instancji Range . |
break | Range | Rozdziel wszystkie komórki scalone poziomo lub pionowo zawarte w liście zakresów na pojedyncze komórki. |
check() | Range | Stan pól wyboru w zakresie zmieni się na „zaznaczone”. |
clear() | Range | Czyści zakres treści, formatów i reguł walidacji danych dla każdego Range na liście zakresów. |
clear(options) | Range | Czyści zakres treści, format, reguły sprawdzania poprawności danych i komentarze zgodnie z określonymi opcjami. |
clear | Range | Czyści zawartość każdego elementu Range na liście zakresów, nie zmieniając formatowania. |
clear | Range | Czyści reguły sprawdzania poprawności danych dla każdego Range na liście zakresów. |
clear | Range | Usuwa formatowanie tekstu dla każdego Range na liście zakresów. |
clear | Range | Czyści notatkę dla każdego Range na liście zakresów. |
get | Range[] | Zwraca listę co najmniej 1 wystąpienia funkcji Range na tym samym arkuszu. |
insert | Range | Wstawia pola wyboru w każdej komórce w zakresie, skonfigurowane za pomocą true dla zaznaczonych i false dla niezaznaczonych. |
insert | Range | Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonego pola i pustym ciągiem znaków dla niezaznaczonego pola. |
insert | Range | Wstawia pola wyboru w każdej komórce zakresu, skonfigurowane z niestandardowymi wartościami dla zaznaczonych i niezaznaczonych stanów. |
remove | Range | usuwa wszystkie pola wyboru z zakresu. |
set | Range | Ustawia kolor tła dla każdego 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 (kolor lub styl) dla każdego kroku Range na liście zakresów. |
set | Range | Ustawia kolor czcionki dla każdego Range na liście zakresów. |
set | Range | Ustawia rodzinę czcionek dla każdego Range na liście zakresów. |
set | Range | Ustawia styl linii czcionki dla każdego Range na liście zakresów. |
set | Range | Ustawia rozmiar czcionki (w punktach) dla każdego Range na liście zakresów. |
set | Range | Ustaw styl czcionki dla każdego Range na liście zakresów. |
set | Range | Ustaw wagę czcionki dla każdego Range na liście zakresów. |
set | Range | Zaktualizuje formułę dla każdego Range na liście zakresów. |
set | Range | Zaktualizuje formułę dla każdego Range na liście zakresów. |
set | Range | Ustaw wyrównanie poziome dla każdego 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 liczby lub daty dla każdego elementu 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 obracania tekstu dla komórek w każdym Range na liście zakresów. |
set | Range | Ustawia wartość dla każdego elementu Range na liście zakresów. |
set | Range | Ustaw wyrównanie pionowe dla każdego Range na liście zakresów. |
set | Range | Określa, czy tekst w komórkach dla każdego Range na liście zakresów ma być ułożony w stos. |
set | Range | Ustaw wcięcie tekstu dla każdego elementu Range na liście zakresów. |
set | Range | Ustawia strategię przenoszenia tekstu dla każdego Range na liście zakresów. |
trim | Range | Obcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce na liście zakresów. |
uncheck() | Range | Stan pól wyboru w zakresie zostanie zmieniony na „niezaznaczone”. |
Szczegółowa dokumentacja
activate()
Wybiera listę instancji Range
. Ostatni zakres na liście jest ustawiony jako active range
.
Uwaga: to pozwala na wielokrotny wybór wielu zakresów.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); const selection = sheet.getSelection(); // Current cell: B2 const currentCell = selection.getCurrentCell(); // Active range: B2:C4 const activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] const activeRangeList = selection.getActiveRangeList();
Powrót
Range
– lista aktywnych zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
break Apart()
Rozdziel wszystkie komórki scalone poziomo lub pionowo zawarte w liście zakresów na pojedyncze komórki.
Wywołanie tej funkcji na liście zakresów jest równoważne wybraniu zestawu zakresów i kliknięciu Formatowanie > Scal > Rozłącz w menu Arkuszy.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Zmienia stan pól wyboru w zakresie na „zaznaczone”. Pomija komórki w zakresie, które nie zawierają obecnie skonfigurowanej wartości zaznaczonej ani niezaznaczonej.
// Changes the state of cells which currently contain either the checked or // unchecked value configured in the ranges D4 and E6 to 'checked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Czyści zakres treści, formatów i reguł walidacji 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 łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Czyści zakres treści, format, reguły sprawdzania poprawności danych i komentarze zgodnie z określonymi opcjami. Domyślnie wszystkie dane są usuwane.
// The code below clears the contents of the following ranges A:A and C:C in the // active sheet, but preserves the format, data validation rules, and comments. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear({contentsOnly: true});
Parametry
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 usunąć tylko komentarze. |
contents | Boolean | Określa, czy ma zostać wyczyszczona tylko zawartość. |
format | Boolean | Czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł sprawdzania poprawności danych. |
validations | Boolean | Określ, czy chcesz usunąć tylko reguły sprawdzania poprawności danych. |
skip | Boolean | Określa, czy należy unikać usuwania odfiltrowanych wierszy. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Content()
Czyści zawartość każdego elementu Range
na liście zakresów, nie zmieniając formatowania.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Data Validations()
Czyści reguły sprawdzania poprawności danych dla każdego Range
na liście zakresów.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Format()
Usuwa formatowanie tekstu dla każdego Range
na liście zakresów.
Spowoduje to usunięcie formatowania tekstu w każdym zakresie, ale nie spowoduje zresetowania żadnych reguł formatowania liczb.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Note()
Czyści notatkę dla każdego Range
na liście zakresów.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Ranges()
Zwraca listę co najmniej 1 wystąpienia funkcji Range
na tym samym arkuszu.
Powrót
Range[]
– lista zakresów.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes()
Wstawia pola wyboru w każdej komórce w zakresie, skonfigurowane za pomocą true
dla zaznaczonych i false
dla niezaznaczonych. Ustawia wartość wszystkich komórek w zakresie na false
.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with // 'true' for checked and 'false' for unchecked. Also, sets the value of each // cell in the ranges D4 and E6 to 'false'. rangeList.insertCheckboxes();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue)
Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonego pola i pustym ciągiem znaków dla niezaznaczonego pola. Ustawia wartość każdej komórki w zakresie na pusty ciąg znaków.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with // 'yes' for checked and the empty string for unchecked. Also, sets the value of // each cell in the ranges D4 and E6 to the empty string. rangeList.insertCheckboxes('yes');
Parametry
Nazwa | Typ | Opis |
---|---|---|
checked | Object | Zaznaczona wartość walidacji danych pola wyboru. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue, uncheckedValue)
Wstawia pola wyboru w każdej komórce zakresu, skonfigurowane z niestandardowymi wartościami dla zaznaczonych i niezaznaczonych stanów. Ustawia wartość każdej komórki w zakresie na niestandardową wartość niezaznaczoną.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with // 'yes' for checked and 'no' for unchecked. Also, sets the value of each cell // in the ranges D4 and E6 to 'no'. rangeList.insertCheckboxes('yes', 'no');
Parametry
Nazwa | Typ | Opis |
---|---|---|
checked | Object | Zaznaczona wartość walidacji danych pola wyboru. |
unchecked | Object | Wartość niezaznaczonego pola wyboru w przypadku walidacji danych. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove Checkboxes()
usuwa wszystkie pola wyboru z zakresu. Usuwa sprawdzanie poprawności danych z każdej komórki, a dodatkowo usuwa jej wartość, jeśli zawiera ona wartość zaznaczoną lub niezaznaczoną.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); const rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']); rangeList1.setValue('yes'); // Removes the checkbox data validation in cells A1 and A3 and clears their // value. rangeList1.removeCheckboxes(); const rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']); rangeList2.setValue('random'); // Removes the checkbox data validation in cells A5 and A7 but does not clear // their value. rangeList2.removeCheckboxes();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background(color)
Ustawia kolor tła dla każdego Range
na liście zakresów. Kolor jest reprezentowany za pomocą zapisu w notacji CSS, np. '#ffffff'
lub 'white'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kod koloru tła w notacji CSS, np. '#ffffff' lub 'white' ; wartość null zeruje kolor. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background RGB(red, green, blue)
Ustawia tło na podany kolor RGB. Jest to wygodna obudowa 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ść zielonego w notacji RGB. |
blue | Integer | Wartość niebieskiego w notacji RGB. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 oznacza obramowanie, false brak obramowania, null brak zmian. |
left | Boolean | true oznacza obramowanie, false brak obramowania, null brak zmian. |
bottom | Boolean | true oznacza obramowanie, false brak obramowania, null brak zmian. |
right | Boolean | true oznacza obramowanie, false brak obramowania, null brak zmian. |
vertical | Boolean | true – wewnętrzne pionowe obramowania, false – brak obramowania, null – brak zmian. |
horizontal | Boolean | true – wewnętrzne poziome obramowania, false – brak obramowania, null – brak zmian. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal, color, style)
Ustawia właściwość obramowania (kolor lub styl) dla każdego kroku Range
na liście zakresów.
Prawidłowe wartości to true
(włączone), false
(wyłączone) i null
(bez zmian). Kolor jest reprezentowany za pomocą notacji CSS, 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 oznacza obramowanie, false brak obramowania, null brak zmian. |
left | Boolean | true oznacza obramowanie, false brak obramowania, null brak zmian. |
bottom | Boolean | true oznacza obramowanie, false brak obramowania, null brak zmian. |
right | Boolean | true oznacza obramowanie, false brak obramowania, null brak zmian. |
vertical | Boolean | true – wewnętrzne pionowe obramowania, false – brak obramowania, null – brak zmian. |
horizontal | Boolean | true – wewnętrzne poziome obramowania, false – brak obramowania, null – brak zmian. |
color | String | Kolor obramowania w notacji CSS, np. '#ffffff' lub 'white' , null dla koloru domyślnego (czarnego). |
style | Border | Styl obramowania, null dla stylu domyślnego (ciągłego). |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Color(color)
Ustawia kolor czcionki dla każdego Range
na liście zakresów. Kolor jest reprezentowany za pomocą notacji CSS, np. '#ffffff'
lub 'white'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor czcionki w notacji CSS, np. '#ffffff' lub 'white' ; wartość null zeruje kolor. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Family(fontFamily)
Ustawia rodzinę czcionek dla każdego Range
na liście zakresów. Rodzina czcionek jest opisana za pomocą identyfikatora ciągu znaków, takiego jak Arial
lub Roboto
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | String | Rodzina czcionek do ustawienia; wartość null zeruje rodzinę czcionek. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Line(fontLine)
Ustawia styl linii czcionki dla każdego Range
na liście zakresów. Opcje stylów linii to 'underline'
, 'line-through'
i 'none'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | String | Styl linii czcionki: 'underline' , 'line-through' lub 'none' ; wartość null zeruje styl linii czcionki. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Size(size)
Ustawia rozmiar czcionki (w punktach) dla każdego Range
na liście zakresów.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametry
Nazwa | Typ | Opis |
---|---|---|
size | Integer | Rozmiar czcionki w punktach. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Style(fontStyle)
Ustaw styl czcionki dla każdego Range
na liście zakresów. Opcje stylu czcionki to 'italic'
lub 'normal'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle('italic');
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | String | Styl czcionki: 'italic' lub 'normal' . Wartość null zresetuje styl czcionki. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Weight(fontWeight)
Ustaw wagę czcionki dla każdego Range
na liście zakresów. Opcje grubości czcionki to 'normal'
lub 'bold'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | String | Grubość czcionki: 'bold' lub 'normal' ; wartość null zeruje grubość czcionki. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula(formula)
Zaktualizuje formułę dla każdego Range
na liście zakresów. Formuła musi być w notacji A1.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Ciąg tekstowy reprezentujący formułę do ustawienia. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula R1C1(formula)
Zaktualizuje formułę dla każdego Range
na liście zakresów. Podana formuła musi być w notacji R1C1.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A11', 'C11']); // This sets the formula to be the sum of the 3 rows above B5 rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Formuła tekstowa. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Horizontal Alignment(alignment)
Ustaw wyrównanie poziome dla każdego Range
na liście zakresów. Opcje wyrównania to 'left'
, 'center'
i 'right'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setHorizontalAlignment('center');
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignment | String | Wyrównanie: 'left' , 'center' lub 'normal' ; wartość null zeruje wyrównanie. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 powoduje usunięcie notatki. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Number Format(numberFormat)
Ustawia format liczby lub daty dla każdego elementu Range
na liście zakresów.
Akceptowane wzorce formatowania opisane są w przewodniku po formatowaniu dat i liczb w interfejsie Sheets API.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Always show 3 decimal points for the specified ranges. rangeList.setNumberFormat('0.000');
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | String | Ciąg tekstowy formatu liczby. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 wyświetlić hiperlink. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Direction(direction)
Ustawia kierunek tekstu w komórkach w każdym Range
na liście zakresów. Jeśli kierunek null
jest określony, jest on wywnioskowany, a następnie ustawiany.
// Sets right-to-left text direction each range in the range list. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametry
Nazwa | Typ | Opis |
---|---|---|
direction | Text | Pożądany kierunek tekstu; jeśli null , kierunek jest określany przed ustawieniem. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Rotation(degrees)
Ustawia ustawienia obracania tekstu dla komórek w każdym Range
na liście zakresów. Ten parametr odpowiada kątowi między standardową orientacją tekstu a pożądaną orientacją. Wartość 0 oznacza, że tekst ma standardową orientację.
W przypadku tekstu od lewej do prawej dodatnie nachylone kąty są skierowane przeciwnie do ruchu wskazówek zegara, a w przypadku tekstu od prawej do lewej – zgodnie z ruchem wskazówek zegara.
// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 // degrees. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
Parametry
Nazwa | Typ | Opis |
---|---|---|
degrees | Integer | Pożądany kąt między standardową orientacją a pożądaną orientacją. W przypadku tekstu od lewej do prawej kąty dodatnie są w kierunku przeciwnym do ruchu wskazówek zegara. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Value(value)
Ustawia wartość dla każdego elementu Range
na liście zakresów. Wartość może być liczbą, ciągiem znaków, wartością logiczną lub datą. Jeśli zaczyna się od „=”, jest interpretowany jako formuła.
const sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | Object | Wartość zakresu. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Alignment(alignment)
Ustaw wyrównanie pionowe dla każdego Range
na liście zakresów. Opcje wyrównania to 'top'
, 'middle'
lub 'bottom'
.
// Sets the vertical alignment to middle for the list of ranges. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment('middle');
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignment | String | Wyrównanie: 'top' , 'middle' lub 'bottom' ; wartość null zeruje wyrównanie. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Text(isVertical)
Określa, czy tekst w komórkach dla każdego Range
na liście zakresów ma być ułożony w stos. Jeśli tekst jest ułożony w wiele wierszy, ustawienie stopnia obrotu tekstu jest ignorowane.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
is | Boolean | Określa, czy tekst ma być ułożony w strefach. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Wrap(isWrapEnabled)
Ustaw wcięcie 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 przewijaniem wyświetlają jak najwięcej tekstu, nie zmieniając jego rozmiaru ani nie rozciągając go na kilka wierszy.
// Enable text wrap for the list of ranges. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
is | Boolean | Czy tekst ma być zawijany. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Wrap Strategy(strategy)
Ustawia strategię przenoszenia tekstu dla każdego Range
na liście zakresów.
// Sets the list of ranges to use the clip wrap strategy. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametry
Nazwa | Typ | Opis |
---|---|---|
strategy | Wrap | Wybrana strategia zawijania. |
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trim Whitespace()
Obcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce na liście zakresów. Usuwa wszystkie odstępy na początku i końcu tekstu w każdej komórce oraz zamienia pozostałe odstępy na pojedynczą spację.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('A1:A4'); range.activate(); range.setValues([ ' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)', ]); const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); const values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', // '=SUM(1,2)']
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Zobacz też
uncheck()
Zmienia stan pól wyboru w zakresie na „niezaznaczone”. Ignoruje komórki w zakresie, które nie zawierają skonfigurowanej wartości zaznaczenia lub niezaznaczenia.
// Changes the state of cells which currently contain either the checked or // unchecked value configured in the ranges D4 and E6 to 'unchecked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Powrót
Range
– ta lista zakresów do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets