Kolekcja zawierająca co najmniej 1 instancję Range
w tym samym arkuszu. Możesz korzystać z tych zajęć
możesz wykonać operacje na zbiorach komórek lub zakresów, które do siebie nie przylegają.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
activate() | RangeList | Wybiera listę Range instancji. |
breakApart() | RangeList | Podziel wszystkie komórki scalone w poziomie lub w pionie zawarte na liście zakresów na z poszczególnych komórek. |
check() | RangeList | Zmienia stan pól wyboru w zakresie na „zaznaczone”. |
clear() | RangeList | Usuwa zakres treści, formatów i reguł weryfikacji danych w przypadku każdego elementu Range w
listę zakresów. |
clear(options) | RangeList | Czyści zakres treści, formatu, reguł sprawdzania poprawności danych i komentarze zgodnie z parametrem podanych opcji. |
clearContent() | RangeList | Usuwa zawartość poszczególnych elementów Range na liście zakresów, pozostawiając formatowanie bez zmian. |
clearDataValidations() | RangeList | Usuwa reguły sprawdzania poprawności danych dla każdego elementu Range na liście zakresów. |
clearFormat() | RangeList | Usuwa formatowanie tekstu dla każdego elementu Range na liście zakresów. |
clearNote() | RangeList | Usuwa notatkę dla każdego elementu Range na liście zakresów. |
getRanges() | Range[] | Zwraca listę co najmniej 1 instancji Range w tym samym arkuszu. |
insertCheckboxes() | RangeList | Wstawia pola wyboru do każdej komórki w zakresie, przy czym zaznaczono przy użyciu true
false (pole niezaznaczone). |
insertCheckboxes(checkedValue) | RangeList | Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowaną za pomocą niestandardowej wartości dla zaznaczonych i pusty ciąg znaków dla niezaznaczonego. |
insertCheckboxes(checkedValue, uncheckedValue) | RangeList | Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane za pomocą niestandardowych wartości zaznaczonych i stany niezaznaczone. |
removeCheckboxes() | RangeList | Usuwa wszystkie pola wyboru z zakresu. |
setBackground(color) | RangeList | Określa kolor tła każdego elementu typu Range na liście zakresów. |
setBackgroundRGB(red, green, blue) | RangeList | Ustawia tło na dany kolor 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 | Określa właściwość obramowania z kolorem lub stylem dla każdego elementu Range na liście zakresów. |
setFontColor(color) | RangeList | Określa kolor czcionki każdego elementu Range na liście zakresów. |
setFontFamily(fontFamily) | RangeList | Określa rodzinę czcionek dla każdego elementu typu 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 typu 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łę każdego pola Range na liście zakresów. |
setFormulaR1C1(formula) | RangeList | Aktualizuje formułę każdego pola 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 | Określa 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 | Określa kierunek tekstu w komórkach w komórkach zakresu Range na liście zakresów. |
setTextRotation(degrees) | RangeList | Określa ustawienia rotacji tekstu dla komórek w poszczególnych komórkach Range na liście zakresów. |
setValue(value) | RangeList | Określa wartość każdego pola 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 tekst w komórkach z każdego elementu Range w zakresie ma być nakładany
z listy. |
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 | Powoduje usunięcie spacji (np. spacji, tabulatorów lub nowych wierszy) we wszystkich komórkach na liście zakresów. |
uncheck() | RangeList | Zmienia stan pól wyboru w zakresie na „niezaznaczone”. |
Szczegółowa dokumentacja
activate()
Wybiera listę Range
instancji. Ostatni zakres na liście to active range
.
Uwaga: w ten sposób możesz wybrać wiele zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Powrót
RangeList
– lista aktywnych zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Podziel wszystkie komórki scalone w poziomie lub w pionie zawarte na liście zakresów na z poszczególnych komórek.
Wywołanie tej funkcji na liście zakresów jest równoważne wybraniu zbioru zakresów i wybierając format Format > Scal > Rozdziel pozycję menu Arkuszy.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Zmienia stan pól wyboru w zakresie na „zaznaczone”. Ignoruje komórki w zakresie , które obecnie nie zawierają ani wartości zaznaczonej, ani niezaznaczonej.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'checked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Usuwa zakres treści, formatów i reguł weryfikacji danych w przypadku każdego elementu Range
w
listę zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Czyści zakres treści, formatu, reguł sprawdzania poprawności danych i komentarze zgodnie z parametrem podanych opcji. Domyślnie wszystkie dane są usuwane.
// The code below clears the contents of the following ranges A:A and C:C in the active sheet, // but preserves the format, data validation rules, and comments. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear({contentsOnly: true});
Parametry
Nazwa | Typ | Opis |
---|---|---|
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
commentsOnly | Boolean | Określa, czy usunąć tylko komentarze. |
contentsOnly | Boolean | Określa, czy wyczyścić tylko zawartość. |
formatOnly | Boolean | Określa, czy wyczyścić tylko format; pamiętaj, że usunięcie usuwa też reguły sprawdzania poprawności danych. |
validationsOnly | Boolean | Określa, czy usuwać tylko reguły sprawdzania poprawności danych. |
skipFilteredRows | Boolean | Określa, czy unikać czyszczenia odfiltrowanych wierszy. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Usuwa zawartość poszczególnych elementów Range
na liście zakresów, pozostawiając formatowanie bez zmian.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Usuwa reguły sprawdzania poprawności danych dla każdego elementu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Usuwa formatowanie tekstu dla każdego elementu Range
na liście zakresów.
Spowoduje to wyczyszczenie formatowania tekstu w każdym zakresie. Nie spowoduje to zresetowania żadnych reguł formatowania liczb.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Usuwa notatkę dla każdego elementu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRanges()
Zwraca listę co najmniej 1 instancji Range
w tym samym arkuszu.
Powrót
Range[]
– lista zakresów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
Wstawia pola wyboru do każdej komórki w zakresie, przy czym zaznaczono przy użyciu true
false
(pole niezaznaczone). Ustawia wartość wszystkich komórek w zakresie na false
.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to // 'false'. rangeList.insertCheckboxes();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowaną za pomocą niestandardowej wartości dla zaznaczonych i puste pole do niezaznaczenia. Ustawia pustą wartość każdej komórki w zakresie na pusty ciąg znaków.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and // E6 to the empty string. rangeList.insertCheckboxes('yes');
Parametry
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Zaznaczona wartość pola sprawdzania poprawności danych. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
Wstawia pola wyboru do każdej komórki w zakresie, przy czym skonfigurowane wartości niestandardowe dla zaznaczonych komórek i stany niezaznaczone. Ustawia wartość w każdej komórce zakresu na niestandardową, niezaznaczoną wartość.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'. rangeList.insertCheckboxes('yes', 'no');
Parametry
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Zaznaczona wartość pola sprawdzania poprawności danych. |
uncheckedValue | Object | Niezaznaczona wartość pola wyboru sprawdzania poprawności danych. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
Usuwa wszystkie pola wyboru z zakresu. Usuwa sprawdzanie poprawności danych każdej komórki oraz dodatkowo usuwa wartość, jeśli komórka zawiera wartość zaznaczoną lub niezaznaczoną.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']); rangeList1.setValue('yes'); // Removes the checkbox data validation in cells A1 and A3 and clears their value. rangeList1.removeCheckboxes(); var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']); rangeList2.setValue('random'); // Removes the checkbox data validation in cells A5 and A7 but does not clear their value. rangeList2.removeCheckboxes();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Określa kolor tła każdego elementu typu Range
na liście zakresów. Kolor jest reprezentowany w
w notacji CSS; na przykład '#ffffff'
lub 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | kod koloru tła w notacji CSS, np. '#ffffff' lub 'white' ; Wartość null powoduje zresetowanie koloru. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Ustawia tło na dany kolor RGB. Jest to udogodnienie powiązane z wywołaniem setBackground(color)
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); // Sets the background to red for each range in the range list. rangeList.setBackgroundRGB(255, 0, 0);
Parametry
Nazwa | Typ | Opis |
---|---|---|
red | Integer | Wartość czerwona w notacji RGB. |
green | Integer | Zielona wartość w notacji RGB. |
blue | Integer | Wartość niebieska w notacji RGB. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
Ustawia właściwość obramowania dla każdego elementu Range
na liście zakresów. Prawidłowe wartości to
true
(wł.), false
(wyłączony) i null
(bez zmian).
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and // right unchanged. rangeList.setBorder(true, null, true, null, false, false);
Parametry
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 – wewnętrzne obramowanie pionowe, false – brak, null – bez zmian. |
horizontal | Boolean | true – wewnętrzne poziome obramowanie, false – brak, null – bez zmian. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Określa właściwość obramowania z kolorem lub stylem dla każdego elementu Range
na liście zakresów.
Prawidłowe wartości to true
(wł.), false
(wyłączony) i null
(bez zmian). Obecny kolor to
reprezentowane w notacji CSS; na przykład '#ffffff'
lub 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges // A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'. rangeList.setBorder( true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);
Parametry
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 – wewnętrzne obramowanie pionowe, false – brak, null – bez zmian. |
horizontal | Boolean | true – wewnętrzne poziome obramowanie, false – brak, null – bez zmian. |
color | String | Kolor obramowania w notacji CSS, np. '#ffffff' lub 'white' , null w przypadku koloru domyślnego (czarny). |
style | BorderStyle | Styl obramowania, null – styl domyślny (ciągły). |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Określa kolor czcionki każdego elementu Range
na liście zakresów. Kolor jest reprezentowany w CSS
zapis; na przykład '#ffffff'
lub 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor czcionki w notacji CSS, np. '#ffffff' lub 'white' ; w
Wartość null resetuje kolor. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
Określa rodzinę czcionek dla każdego elementu typu Range
na liście zakresów. Rodzina czcionek została opisana.
za pomocą identyfikatora ciągu znaków, takiego jak Arial
lub Roboto
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontFamily | String | Rodzina czcionek do ustawienia; wartość null resetuje rodzinę czcionek. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Ustawia styl linii czcionki dla każdego elementu Range
na liście zakresów. Opcje stylów linii
to 'underline'
, 'line-through'
lub 'none'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontLine | String | styl linii czcionki: 'underline' , 'line-through' lub
'none' ; wartość null resetuje styl linii czcionki. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Ustawia rozmiar czcionki (w punktach) dla każdego elementu typu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametry
Nazwa | Typ | Opis |
---|---|---|
size | Integer | rozmiar punktu czcionki. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Ustaw styl czcionki dla każdego elementu Range
na liście zakresów. Dostępne są następujące opcje stylu czcionki
'italic'
lub 'normal'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle("italic");
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontStyle | String | styl czcionki ('italic' lub 'normal' ); null
resetuje styl czcionki. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
Ustaw grubość czcionki dla każdego elementu Range
na liście zakresów. Dostępne są następujące grubości czcionki
'normal'
lub 'bold'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametry
Nazwa | Typ | Opis |
---|---|---|
fontWeight | String | Grubość czcionki: 'bold' lub 'normal' ; null
resetuje grubość czcionki. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aktualizuje formułę każdego pola Range
na liście zakresów. Podana formuła musi znajdować się w argumencie
Zapis A1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Ciąg znaków reprezentujący formułę do ustawienia. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Aktualizuje formułę każdego pola Range
na liście zakresów. Podana formuła musi znajdować się w argumencie
R1C1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); // This sets the formula to be the sum of the 3 rows above B5 rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Formuła ciągu znaków. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Ustaw wyrównanie w poziomie dla każdego elementu Range
na liście zakresów. Opcje wyrównania
to 'left'
, 'center'
lub 'right'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setHorizontalAlignment("center");
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignment | String | Wyrównanie: 'left' , 'center' lub 'normal' ; w
Wartość null resetuje wyrównanie. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNote(note)
Ustawia tekst notatki dla każdego elementu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setNote('This is a note');
Parametry
Nazwa | Typ | Opis |
---|---|---|
note | String | tekst notatki do ustawienia; Wartość null usuwa notatkę. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormat(numberFormat)
Określa format liczb lub daty dla każdego elementu Range
na liście zakresów.
Akceptowane wzorce formatowania opisano w przewodniku po formatowaniu dat i liczb w interfejsie Arkuszy API.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Always show 3 decimal points for the specified ranges. rangeList.setNumberFormat('0.000');
Parametry
Nazwa | Typ | Opis |
---|---|---|
numberFormat | String | Ciąg w formacie liczbowym. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 ma być wyświetlany hiperlink. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Określa kierunek tekstu w komórkach w poszczególnych komórkach Range
na liście zakresów. Jeśli
w podanym kierunku to null
, kierunek jest ustalany i ustawiany.
// Sets right-to-left text direction each range in the range list. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametry
Nazwa | Typ | Opis |
---|---|---|
direction | TextDirection | żądany kierunek tekstu; jeśli null , kierunek jest ustalany wcześniej
. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Określa ustawienia rotacji tekstu dla komórek w poszczególnych komórkach Range
na liście zakresów.
odpowiada kątowi między standardową orientacją tekstu a
orientacji ekranu. Wartość 0 oznacza, że tekst jest ustawiony w orientacji standardowej.
W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są w kierunku przeciwnym do ruchu wskazówek zegara, a od prawej do lewej – w kierunku ruchu wskazówek zegara.
// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
Parametry
Nazwa | Typ | Opis |
---|---|---|
degrees | Integer | Żądany kąt między orientacją standardową a żądaną orientacją. W przypadku tekstu od lewej do prawej kąty dodatnie są zapisane w kierunku przeciwnym do ruchu wskazówek zegara. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
Określa wartość każdego pola Range
na liście zakresów. Wartością może być liczba, ciąg,
wartość logiczna lub data. Jeśli zaczyna się od „=” interpretowany jest jako wzór.
var sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | Object | Wartość zakresu. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Ustaw wyrównanie w pionie dla każdego elementu Range
na liście zakresów. Opcje wyrównania
to 'top'
, 'middle'
lub 'bottom'
.
// Sets the vertical alignment to middle for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment("middle");
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignment | String | Wyrównanie: 'top' , 'middle' lub 'bottom' ; w
Wartość null resetuje wyrównanie. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalText(isVertical)
Określa, czy tekst w komórkach z każdego elementu Range
w zakresie ma być nakładany
z listy. Jeśli tekst jest ułożony pionowo, ustawienie stopni obrotu tekstu jest ignorowane.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
isVertical | Boolean | Określa, czy tekst ma być nakładany na stos. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
Ustaw zawijanie tekstu dla każdego elementu Range
na liście zakresów. Zmiana rozmiaru komórek z włączonym zawijaniem
wyświetlając ich pełną treść. Komórki z wyłączonym zawijaniem wyświetlają się w miarę możliwości
bez zmiany rozmiaru i wyświetlania w kilku liniach.
// Enable text wrap for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
isWrapEnabled | Boolean | Określa, czy tekst ma być zawijany. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
Ustawia strategię zawijania tekstu dla każdego elementu Range
na liście zakresów.
// Sets the list of ranges to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametry
Nazwa | Typ | Opis |
---|---|---|
strategy | WrapStrategy | Pożądana strategia opakowań. |
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Powoduje usunięcie spacji (np. spacji, tabulatorów lub nowych wierszy) we wszystkich komórkach na liście zakresów. Usuwa wszystkie spacje z początku i końca tekstu każdej komórki oraz zmniejsza kolejne podsekwencje pozostałych znaków odstępu na pojedynczą spację.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']); var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Zobacz też
uncheck()
Zmienia stan pól wyboru w zakresie na „niezaznaczone”. Ignoruje komórki w zakresie , które obecnie nie zawierają ani wartości zaznaczonej, ani niezaznaczonej.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'unchecked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Powrót
RangeList
– lista zakresów do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets