Zbiór zawierający co najmniej 1 instancję Range
w tym samym arkuszu. Za pomocą tej klasy możesz wykonywać operacje na zbiorach zakresów lub komórek, które nie sąsiadują ze sobą.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
activate() | RangeList | Wybiera listę instancji (Range ). |
breakApart() | RangeList | Ponownie podziel wszystkie scalone w poziomie lub pionowo komórki z listy zakresów na poszczególne komórki. |
check() | RangeList | Zmienia stan pól wyboru w zakresie na „zaznaczone”. |
clear() | RangeList | Czyści zakres treści, formatów i reguł sprawdzania poprawności danych dla każdego elementu Range na liście zakresów. |
clear(options) | RangeList | Usuwa zakres treści, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z określonymi opcjami. |
clearContent() | RangeList | Usuwa treść każdego elementu Range na liście zakresów, pozostawiając formatowanie bez zmian. |
clearDataValidations() | RangeList | Czyści reguły sprawdzania poprawności danych dla każdego elementu Range na liście zakresów. |
clearFormat() | RangeList | Usuwa formatowanie tekstu w każdym polu Range na liście zakresów. |
clearNote() | RangeList | Usuwa notatkę z każdego elementu Range na liście zakresów. |
getRanges() | Range[] | Zwraca listę co najmniej 1 instancji Range w tym samym arkuszu. |
insertCheckboxes() | RangeList | Wstawia pola wyboru w każdej komórce w zakresie z zaznaczoną wartością true i odznaczoną false . |
insertCheckboxes(checkedValue) | RangeList | Wstawia pola wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem znaków, jeśli nie jest zaznaczone. |
insertCheckboxes(checkedValue, uncheckedValue) | RangeList | Wstawia pola wyboru do każdej komórki w zakresie skonfigurowanych przy użyciu niestandardowych wartości stanów zaznaczonego i odznaczonego. |
removeCheckboxes() | RangeList | Usuwa wszystkie pola wyboru z zakresu. |
setBackground(color) | RangeList | Ustawia kolor tła każdego elementu Range na liście zakresów. |
setBackgroundRGB(red, green, blue) | RangeList | Ustawia podany kolor tła RGB. |
setBorder(top, left, bottom, right, vertical, horizontal) | RangeList | Ustawia właściwość obramowania dla każdego elementu Range na liście zakresów. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | RangeList | Dla każdego elementu Range na liście zakresów ustawia właściwość obramowania z kolorem lub stylem. |
setFontColor(color) | RangeList | Ustawia kolor czcionki dla każdego elementu Range na liście zakresów. |
setFontFamily(fontFamily) | RangeList | Ustawia rodzinę czcionek dla każdego elementu Range na liście zakresów. |
setFontLine(fontLine) | RangeList | Ustawia styl linii czcionki dla każdego elementu Range na liście zakresów. |
setFontSize(size) | RangeList | Ustawia rozmiar czcionki (w punktach) dla każdego elementu Range na liście zakresów. |
setFontStyle(fontStyle) | RangeList | Ustaw styl czcionki dla każdego elementu Range na liście zakresów. |
setFontWeight(fontWeight) | RangeList | Ustaw grubość czcionki dla każdego elementu Range na liście zakresów. |
setFormula(formula) | RangeList | Aktualizuje formułę dla każdego elementu Range na liście zakresów. |
setFormulaR1C1(formula) | RangeList | Aktualizuje formułę dla każdego elementu Range na liście zakresów. |
setHorizontalAlignment(alignment) | RangeList | Ustaw wyrównanie w poziomie dla każdego elementu Range na liście zakresów. |
setNote(note) | RangeList | Ustawia tekst notatki dla każdego elementu Range na liście zakresów. |
setNumberFormat(numberFormat) | RangeList | Ustawia format liczb lub daty dla każdego elementu Range na liście zakresów. |
setShowHyperlink(showHyperlink) | RangeList | Określa, czy każdy element Range na liście zakresów ma wyświetlać hiperlinki. |
setTextDirection(direction) | RangeList | Ustawia kierunek tekstu w komórkach każdego elementu Range na liście zakresu. |
setTextRotation(degrees) | RangeList | Ustawia ustawienia rotacji tekstu dla komórek w każdym elemencie Range na liście zakresów. |
setValue(value) | RangeList | Ustawia wartość każdego parametru Range na liście zakresów. |
setVerticalAlignment(alignment) | RangeList | Ustaw wyrównanie w pionie dla każdego elementu Range na liście zakresów. |
setVerticalText(isVertical) | RangeList | Określa, czy dla każdego elementu Range na liście zakresu ma być wyświetlany tekst w komórkach. |
setWrap(isWrapEnabled) | RangeList | Ustaw zawijanie tekstu dla każdego elementu Range na liście zakresów. |
setWrapStrategy(strategy) | RangeList | Ustawia strategię zawijania tekstu dla każdego elementu Range na liście zakresów. |
trimWhitespace() | RangeList | Usuwa odstępy (np. spacje, tabulatory lub nowe wiersze) każdej komórki na liście zakresów. |
uncheck() | RangeList | Zmienia stan pól wyboru w zakresie na „odznaczone”. |
Szczegółowa dokumentacja
activate()
Wybiera listę instancji (Range
). Ostatni zakres na liście to active range
.
Uwaga: w ten sposób możesz zaznaczyć 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();
Powroty
RangeList
– lista aktywnych zakresów na potrzeby łańcuchów.
Upoważnienie
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()
Ponownie podziel wszystkie scalone w poziomie lub pionowo komórki z listy zakresów na poszczególne komórki.
Wywołanie tej funkcji na liście zakresów jest równoważne z wyborem zestawu zakresów i pozycji menu Format > Scal > Rozdziel.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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ą skonfigurowanej ani zaznaczonej, ani niezaznaczonej wartości.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'checked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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()
Czyści zakres treści, formatów i reguł 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.clear();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Usuwa zakres treści, formatu, reguł sprawdzania poprawności danych i komentarzy zgodnie z określonymi opcjami. Domyślnie wszystkie dane są czyszczone.
// 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
Nazwa | Typ | Opis |
---|---|---|
options | Object | Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
commentsOnly | Boolean | Czy usuwać tylko komentarze. |
contentsOnly | Boolean | Określa, czy usunąć samą zawartość. |
formatOnly | Boolean | Określa, czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu usuwa też reguły sprawdzania poprawności danych. |
validationsOnly | Boolean | Określa, czy wyczyścić tylko reguły sprawdzania poprawności danych. |
skipFilteredRows | Boolean | Określa, czy nie wyczyścić odfiltrowanych wierszy. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 treść każdego elementu 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();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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()
Czyści 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();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 w każdym polu Range
na liście zakresów.
Spowoduje to usunięcie formatowania tekstu w każdym zakresie, ale nie spowoduje zresetowania żadnych reguł formatowania liczb.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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ę z każdego elementu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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.
Powroty
Range[]
– lista zakresów.
Upoważnienie
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 w każdej komórce w zakresie z zaznaczoną wartością true
i odznaczoną false
. 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();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 z niestandardową wartością zaznaczonego tekstu i pustym ciągiem znaków, jeśli nie jest zaznaczone. Ustawia pusty ciąg znaków w każdej komórce w zakresie.
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
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Wartość pola wyboru sprawdzania poprawności danych. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 skonfigurowanych przy użyciu niestandardowych wartości stanów zaznaczonego i odznaczonego. Ustawia wartość każdej komórki w zakresie na niestandardową wartość niezaznaczoną.
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
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Wartość pola wyboru sprawdzania poprawności danych. |
uncheckedValue | Object | Odznaczona wartość sprawdzania poprawności danych pola wyboru. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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. Czyści funkcję sprawdzania poprawności danych w każdej komórce i usuwa dodatkowo jej wartość, jeśli komórka zawiera zaznaczoną lub niezaznaczoną wartość.
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();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia kolor tła każdego elementu Range
na liście zakresów. Kolor jest podawany w notacji CSS, np. '#ffffff'
lub 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var 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. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 podany kolor tła RGB. Jest to wygodny kod podczas rozmowy w usłudze 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
Nazwa | Typ | Opis |
---|---|---|
red | Integer | Wartość czerwona w notacji RGB. |
green | Integer | Wartość zielona w notacji RGB. |
blue | Integer | Wartość niebieska w notacji RGB. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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
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 – obramowanie pionowe, false – brak, null – bez zmian. |
horizontal | Boolean | true – obramowanie wewnętrzne, false – brak, null – bez zmian. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Dla każdego elementu Range
na liście zakresów ustawia właściwość obramowania z kolorem lub stylem.
Prawidłowe wartości to true
(włączony), false
(wyłączony) i null
(bez zmian). Kolor jest reprezentowany w notacji CSS, np. '#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
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 – obramowanie pionowe, false – brak, null – bez zmian. |
horizontal | Boolean | true – obramowanie wewnętrzne, false – brak, null – bez zmian. |
color | String | Kolor obramowania w notacji CSS, np. '#ffffff' lub 'white' ; null w przypadku koloru domyślnego (czarnego). |
style | BorderStyle | Styl obramowania, null , który oznacza styl domyślny (ciągły). |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia kolor czcionki dla każdego elementu Range
na liście zakresów. Kolor jest reprezentowany w notacji CSS, np. '#ffffff'
lub 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var 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. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia rodzinę czcionek dla każdego elementu Range
na liście zakresów. Rodzina czcionek jest opisana identyfikatorem ciągu znaków, np. Arial
lub Roboto
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontFamily | String | Rodzina czcionek do ustawienia. Wartość null resetuje rodzinę czcionek. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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. Dostępne style linii to 'underline'
, 'line-through'
i 'none'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontLine | String | Styl linii czcionki ('underline' , 'line-through' lub 'none' ). Wartość null resetuje styl linii czcionki. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametry
Nazwa | Typ | Opis |
---|---|---|
size | Integer | Rozmiar czcionki. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 opcje to 'italic'
i 'normal'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle("italic");
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontStyle | String | Styl czcionki, 'italic' lub 'normal' ; wartość null
resetuje styl czcionki. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 opcje grubości czcionki to 'normal'
lub 'bold'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontWeight | String | Grubość czcionki ('bold' lub 'normal' ). Wartość null resetuje grubość czcionki. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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łę dla każdego elementu Range
na liście zakresów. Podana formuła musi być
w notacji A1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Ciąg znaków reprezentujący formułę do ustawienia. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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łę dla każdego elementu Range
na liście zakresów. Podana formuła musi być
w notacji R1C1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); // This sets the formula to be the sum of the 3 rows above B5 rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Formuła ciągu znaków. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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. Dostępne opcje wyrównywania to 'left'
, 'center'
i 'right'
.
var sheet = SpreadsheetApp.getActiveSheet(); var 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. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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
Nazwa | Typ | Opis |
---|---|---|
note | String | Tekst notatki do ustawienia. Wartość null usuwa notatkę. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia format liczb lub daty dla każdego elementu Range
na liście zakresów.
Akceptowane wzorce formatowania zostały opisane w przewodniku po formatowaniu dat i liczb w interfejsie Arkuszy Google.
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
Nazwa | Typ | Opis |
---|---|---|
numberFormat | String | Ciąg w formacie liczby. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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
setShowHyperlink(showHyperlink)
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
Nazwa | Typ | Opis |
---|---|---|
showHyperlink | Boolean | Określa, czy hiperlink ma być wyświetlany. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia kierunek tekstu w komórkach każdego elementu Range
na liście zakresu. Jeśli określony kierunek to null
, kierunek jest określany, a następnie 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
Nazwa | Typ | Opis |
---|---|---|
direction | TextDirection | Żądany kierunek tekstu. Jeśli ma wartość null , kierunek jest ustalany przed ustawieniem. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia ustawienia rotacji tekstu dla komórek w każdym elemencie Range
na liście zakresów. Dane wejściowe odpowiadają kątowi między standardową orientacją tekstu a żądaną orientacją. Wartość 0 oznacza, że tekst ma orientację standardową.
W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są wykonywane w lewo, a od prawej do lewej – w prawo.
// 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
Nazwa | Typ | Opis |
---|---|---|
degrees | Integer | Wybrany kąt między orientacją standardową a żądaną. W przypadku tekstu od lewej do prawej kąty dodatnie są wykonywane w kierunku przeciwnym do ruchu wskazówek zegara. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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)
Ustawia wartość każdego parametru Range
na liście zakresów. Może to być liczba, ciąg znaków, wartość logiczna lub data. Jeśli zaczyna się od „=”, jest interpretowany jako formuła.
var sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | Object | Wartość zakresu. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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. Dostępne opcje wyrównywania 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
Nazwa | Typ | Opis |
---|---|---|
alignment | String | Wyrównanie ('top' , 'middle' lub 'bottom' ). Wartość null resetuje wyrównanie. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 dla każdego elementu Range
na liście zakresu ma być wyświetlany tekst w komórkach. Jeśli tekst jest ułożony pionowo, ustawienie jego obrotu 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
Nazwa | Typ | Opis |
---|---|---|
isVertical | Boolean | Określa, czy tekst ma się nakładać na stos. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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. Komórki z włączonym zawijaniem zmieniają rozmiar,
by wyświetlić ich pełną zawartość. Komórki z wyłączonym zawijaniem wyświetlają się w jak największym stopniu bez konieczności zmiany rozmiaru i przejścia do wielu wierszy.
// Enable text wrap for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
isWrapEnabled | Boolean | Określa, czy tekst ma być zawijany. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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
Nazwa | Typ | Opis |
---|---|---|
strategy | WrapStrategy | Docelowa strategia pakowania. |
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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()
Usuwa odstępy (np. spacje, tabulatory lub nowe wiersze) każdej komórki na liście zakresów. Usuwa wszystkie spacje z początku i końca tekstu w każdej komórce oraz zmniejsza kolejne odstępy do 1 spacji.
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)']
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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 „odznaczone”. Ignoruje komórki w zakresie, które obecnie nie zawierają skonfigurowanej ani zaznaczonej, ani niezaznaczonej wartości.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'unchecked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Powroty
RangeList
– ta lista zakresów na potrzeby łańcuchów.
Upoważnienie
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