Kolekcja co najmniej jednej instancji Range
w tym samym arkuszu. Tej klasy możesz używać do wykonywania operacji na kolekcjach sąsiadujących ze sobą zakresach lub komórkach.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
activate() | RangeList | Wybiera listę instancji Range . |
breakApart() | RangeList | Ponownie podziel wszystkie komórki w poziomie lub w pionie na liście 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ł weryfikacji danych dla każdego elementu Range na liście zakresów. |
clear(options) | RangeList | Czyści zakres treści, formatu, reguł weryfikacji danych i komentarzy zgodnie z określonymi opcjami. |
clearContent() | RangeList | Usuwa zawartość każdego elementu Range z listy zakresów, zachowując formatowanie. |
clearDataValidations() | RangeList | Czyści reguły weryfikacji danych dla każdego typu Range na liście zakresów. |
clearFormat() | RangeList | Czyści formatowanie tekstu dla każdego elementu Range na liście zakresów. |
clearNote() | RangeList | Czyści notatkę dla każdego elementu Range na liście zakresów. |
getRanges() | Range[] | Zwraca listę co najmniej jednej instancji Range w tym samym arkuszu. |
insertCheckboxes() | RangeList | Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane za pomocą zasady true jako zaznaczone i false do odznaczenia. |
insertCheckboxes(checkedValue) | RangeList | Wstawia pola wyboru w każdej komórce zakresu, Skonfigurowane z użyciem niestandardowej wartości zaznaczonej i pustego ciągu niezaznaczonego. |
insertCheckboxes(checkedValue, uncheckedValue) | RangeList | Wstawia pola wyboru do każdej komórki w zakresie wraz z wartościami niestandardowymi dla stanów zaznaczenia i odznaczonych. |
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 kolor tła na określony 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 | Ustawia właściwość obramowania dla koloru lub stylu dla każdego elementu Range na liście zakresów. |
setFontColor(color) | RangeList | Ustawia kolor czcionki w przypadku każdego elementu Range z listy. |
setFontFamily(fontFamily) | RangeList | Ustawia rodzinę czcionek dla każdego elementu Range na liście zakresów. |
setFontLine(fontLine) | RangeList | Ustawia styl linii czcionek w każdym polu Range z listy. |
setFontSize(size) | RangeList | Ustawia rozmiar czcionki (w punktach) każdego elementu Range z listy. |
setFontStyle(fontStyle) | RangeList | Ustaw styl czcionki w przypadku każdego elementu Range z listy. |
setFontWeight(fontWeight) | RangeList | Ustaw grubość czcionki dla każdego elementu Range na liście zakresów. |
setFormula(formula) | RangeList | Aktualizuje formułę dla każdego typu Range na liście zakresów. |
setFormulaR1C1(formula) | RangeList | Aktualizuje formułę dla każdego typu Range na liście zakresów. |
setHorizontalAlignment(alignment) | RangeList | Wyrównaj w poziomie dla każdego elementu Range z listy zakresów. |
setNote(note) | RangeList | Ustawia tekst notatki dla każdego wymiaru Range z listy. |
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żde Range na liście zakresów ma wyświetlać hiperlinki. |
setTextDirection(direction) | RangeList | Ustawia kierunek tekstowy dla komórek w każdej kolumnie Range na liście zakresów. |
setTextRotation(degrees) | RangeList | Ustawia ustawienia rotacji tekstu w komórkach w każdej kolumnie Range na liście zakresów. |
setValue(value) | RangeList | Ustawia wartość dla każdego elementu Range na liście zakresów. |
setVerticalAlignment(alignment) | RangeList | Ustaw wyrównanie w pionie do każdego elementu Range na liście zakresów. |
setVerticalText(isVertical) | RangeList | Określa, czy tekst każdej komórki Range na liście zakresów ma być ułożony. |
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 z listy. |
trimWhitespace() | RangeList | Przycina spacje do wszystkich komórek na tej liście zakresów (np. spacje, karty lub nowe wiersze). |
uncheck() | RangeList | Zmienia stan pól wyboru w zakresie na „odznaczone”. |
Szczegółowa dokumentacja
activate()
Wybiera listę instancji Range
. Ostatni zakres na liście jest ustawiony na active range
.
Uwaga: umożliwia to zaznaczenie wielu 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();
Zwróć
RangeList
– lista aktywnych zakresów na potrzeby łańcucha.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Ponownie podziel wszystkie komórki w poziomie lub w pionie na liście zakresów na poszczególne komórki.
Wywołanie tej funkcji na liście zakresów jest równoważne z wybraniem zestawu zakresów i wybraniem opcji Format > Scal > Rozdziel.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Zmienia stan pól wyboru na „zaznaczone”. Ignoruje komórki z zakresu, który obecnie nie zawiera żadnej zaznaczonej lub nieskonfigurowanej 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();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Czyści zakres treści, formatów i reguł weryfikacji danych dla każdego elementu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Czyści zakres treści, formatu, reguł weryfikacji danych i komentarzy zgodnie z określonymi opcjami. Domyślnie wszystkie dane są wyczyszczone.
// 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 usunąć tylko komentarze |
contentsOnly | Boolean | Określa, czy chcesz usunąć tylko zawartość. |
formatOnly | Boolean | Czy usunąć tylko format – pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł weryfikacji danych. |
validationsOnly | Boolean | Określa, czy usunąć tylko reguły weryfikacji danych. |
skipFilteredRows | Boolean | Określa, czy uniknąć czyszczenia odfiltrowanych wierszy. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Usuwa zawartość każdego elementu Range
z listy zakresów, zachowując formatowanie.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Czyści reguły weryfikacji danych dla każdego typu Range
na liście zakresów.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Czyści formatowanie tekstu dla każdego elementu Range
na liście zakresów.
To spowoduje usunięcie formatowania tekstu dla każdego zakresu, ale nie spowoduje zresetowania żadnych reguł formatowania liczb.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Czyści 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();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRanges()
Zwraca listę co najmniej jednej instancji Range
w tym samym arkuszu.
Zwróć
Range[]
– lista zakresów,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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, skonfigurowane za pomocą zasady true
jako zaznaczone i false
do odznaczenia. 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();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Wstawia pola wyboru w każdej komórce zakresu, Skonfigurowane z użyciem niestandardowej wartości zaznaczonej i pustego ciągu niezaznaczonego. Ustawia 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 | Sprawdzana wartość sprawdzania poprawności danych pola wyboru. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wraz z wartościami niestandardowymi dla stanów zaznaczenia i odznaczonych. Ustawia wartość każdej komórki w zakresie na niestandardową odznaczoną 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 | Sprawdzana wartość sprawdzania poprawności danych pola wyboru. |
uncheckedValue | Object | Niezaznaczona wartość do weryfikacji danych pola wyboru. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 walidację danych każdej komórki i dodatkowo usuwa jej wartość, jeśli komórka zawiera wartość zaznaczoną lub odznaczoną.
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();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wyrażony 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 resetuje kolor. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Ustawia kolor tła na określony kolor RGB. To wygodny komunikat dotyczący wywołania 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 | Niebieska wartość w notacji RGB. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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
(on), 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 dla obramowania, false – brak, null bez zmian. |
left | Boolean | true dla obramowania, false – brak, null bez zmian. |
bottom | Boolean | true dla obramowania, false – brak, null bez zmian. |
right | Boolean | true dla obramowania, false – brak, null bez zmian. |
vertical | Boolean | true – obramowanie wewnętrzne, false – brak, null – bez zmian. |
horizontal | Boolean | true – obramowanie wewnętrzne w poziomie, false – brak, null – bez zmian. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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)
Ustawia właściwość obramowania dla koloru lub stylu dla każdego elementu Range
na liście zakresów.
Prawidłowe wartości to true
(on), false
(wyłączony) i null
(bez zmian). Kolor jest podany 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 dla obramowania, false – brak, null bez zmian. |
left | Boolean | true dla obramowania, false – brak, null bez zmian. |
bottom | Boolean | true dla obramowania, false – brak, null bez zmian. |
right | Boolean | true dla obramowania, false – brak, null bez zmian. |
vertical | Boolean | true – obramowanie wewnętrzne, false – brak, null – bez zmian. |
horizontal | Boolean | true – obramowanie wewnętrzne w poziomie, false – brak, null – bez zmian. |
color | String | Kolor obramowania w notacji CSS, np. '#ffffff' lub 'white' , null , aby zmienić kolor domyślny (czarny). |
style | BorderStyle | Styl obramowań, null – styl domyślny (ciągły). |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Ustawia kolor czcionki w przypadku każdego elementu Range
z listy. Kolor jest podany w notacji CSS, 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' , wartość null resetuje kolor. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 za pomocą identyfikatora ciągu, 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. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Ustawia styl linii czcionek w każdym polu Range
z listy. Opcje stylu 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 czcionki. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Ustawia rozmiar czcionki (w punktach) każdego elementu Range
z listy.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametry
Nazwa | Typ | Opis |
---|---|---|
size | Integer | Rozmiar punktu czcionki. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Ustaw styl czcionki w przypadku każdego elementu Range
z listy. Dostępne typy czcionek to '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' ); wartość null resetuje styl czcionki. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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. 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 | Waga czcionki: 'bold' lub 'normal' ; wartość null resetuje grubość czcionki. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aktualizuje formułę dla każdego typu 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. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Aktualizuje formułę dla każdego typu 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. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Wyrównaj w poziomie dla każdego elementu Range
z listy zakresów. Dostępne 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' ; wartość null resetuje wyrównanie. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 wymiaru Range
z listy.
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, który chcesz ustawić; usunięcie wartości null spowoduje usunięcie notatki. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 znajdziesz w przewodniku po formatowaniu daty i liczby w interfejsie API Arkuszy.
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 liczb. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
Określa, czy każde 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. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Ustawia kierunek tekstowy dla komórek w każdej kolumnie Range
na liście zakresów. Jeśli określony kierunek to null
, kierunek zostanie ustalony, a następnie ustawiony.
// 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 | Oczekiwany kierunek tekstu. Jeśli null jest określony, przed ustawieniem. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Ustawia ustawienia rotacji tekstu w komórkach w każdej kolumnie Range
na liście zakresów. Dane wejściowe odpowiadają kątowi między standardową orientacją tekstową a żądanym położeniem. Wartość wejściowa 0 oznacza, że tekst jest ustawiony na standardową orientację.
W przypadku tekstu tekstowego od lewej do prawej kąty dodatnie są skierowane w lewo, a od prawej do lewej.
// 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 standardową a żądaną orientacją. W przypadku tekstu od lewej do prawej dodatnie kąty są ustawione w lewo. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(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 ciągu '=', 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. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Ustaw wyrównanie w pionie do każdego elementu Range
na liście zakresów. Dostępne 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' ; wartość null resetuje wyrównanie. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalText(isVertical)
Określa, czy tekst każdej komórki Range
na liście zakresów ma być ułożony. Jeśli tekst jest ułożony pionowo, stopień obrotu tekstu jest ignorowany.
// 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ć ułożony, czy nie. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 rozmiarem zawijania wyświetlają pełną treść. Komórki z wyłączonym zawijaniem wyświetlają jak najwięcej reklam bez zmiany rozmiaru lub wyświetlania w wielu wierszach.
// 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 zawijać tekst, czy nie. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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
z listy.
// 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 | Żądana strategia dodawania kodów. |
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Przycina spacje do wszystkich komórek na tej liście zakresów (np. spacje, karty lub nowe wiersze). Usuwa wszystkie odstępy z początku i końca każdej komórki oraz zmniejsza ciąg znaków następujących po pozostałych znakach odstępu.
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)']
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Zobacz też
uncheck()
Zmienia stan pól wyboru na „Niezaznaczone”. Ignoruje komórki z zakresu, który obecnie nie zawiera żadnej zaznaczonej lub nieskonfigurowanej 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();
Zwróć
RangeList
– lista zakresów na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets