Ta strona została przetłumaczona przez Cloud Translation API.

Class Range

Dostęp do zakresów arkuszy kalkulacyjnych i ich modyfikowanie. Zakres może obejmować pojedynczą komórkę w arkuszu lub grupę sąsiednich komórek.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`Range`	Ustawia określony zakres jako `active range`, przy czym lewa górna komórka w zakresie jest ustawiona jako `current cell`.
`activateAsCurrentCell()`	`Range`	Ustawia określoną komórkę jako `current cell`.
`addDeveloperMetadata(key)`	`Range`	Dodaje do zakresu metadane dewelopera z podanym kluczem.
`addDeveloperMetadata(key, visibility)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem.
`addDeveloperMetadata(key, value)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem i wartością.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem, wartością i widocznością.
`applyColumnBanding()`	`Banding`	Stosuje do zakresu domyślny motyw pasma kolumn.
`applyColumnBanding(bandingTheme)`	`Banding`	Stosuje do zakresu wybrany motyw pasma kolumnowego.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje określony zakres pasma do kolumny do zakresu z określonymi ustawieniami nagłówka i stopki.
`applyRowBanding()`	`Banding`	Stosuje domyślny zakres pasma wierszy do zakresu.
`applyRowBanding(bandingTheme)`	`Banding`	Stosuje do zakresu określony motyw pasma wiersza.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje określony zakres opaski do wiersza do zakresu z określonymi ustawieniami nagłówka i stopki.
`autoFill(destination, series)`	`void`	Wypełnia pole `destinationRange` danymi na podstawie danych z tego zakresu.
`autoFillToNeighbor(series)`	`void`	Oblicza zakres do wypełnienia nowymi danymi na podstawie sąsiadujących komórek i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych zawartych w tym zakresie.
`breakApart()`	`Range`	Rozdziel komórki wielokolumnowe w zakresie na poszczególne komórki.
`canEdit()`	`Boolean`	Określa, czy użytkownik ma uprawnienia do edytowania każdej komórki w zakresie.
`check()`	`Range`	Zmienia stan pól wyboru w zakresie na „zaznaczone”.
`clear()`	`Range`	Usuwa zakres treści i formatów.
`clear(options)`	`Range`	Usuwa zakres treści, format, reguły sprawdzania poprawności danych i komentarze określone za pomocą podanych opcji zaawansowanych.
`clearContent()`	`Range`	Czyści zawartość zakresu bez zmiany formatowania.
`clearDataValidations()`	`Range`	Usuwa reguły weryfikacji danych dla danego zakresu.
`clearFormat()`	`Range`	Usuwa formatowanie dla tego zakresu.
`clearNote()`	`Range`	Usuwa notatkę z danej komórki lub komórki.
`collapseGroups()`	`Range`	Zwija wszystkie grupy, które w całości znajdują się w zakresie.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do podanej lokalizacji.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do podanej lokalizacji.
`copyTo(destination)`	`void`	Kopiuje dane z zakresu do innego zakresu komórek.
`copyTo(destination, copyPasteType, transposed)`	`void`	Kopiuje dane z zakresu do innego zakresu komórek.
`copyTo(destination, options)`	`void`	Kopiuje dane z zakresu do innego zakresu komórek.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Skopiuj zawartość zakresu do podanej lokalizacji.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Skopiuj zawartość zakresu do podanej lokalizacji.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Tworzy pustą tabelę przestawną źródła danych, która jest zakotwiczona w pierwszej komórce tego zakresu.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Powoduje utworzenie pustej tabeli źródła danych, która jest zakotwiczona w pierwszej komórce tego zakresu.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca DeveloperMetadataFinderApi do wyszukiwania metadanych dewelopera w zakresie.
`createFilter()`	`Filter`	Tworzy filtr i stosuje go do określonego zakresu w arkuszu.
`createPivotTable(sourceData)`	`PivotTable`	Tworzy pustą tabelę przestawną z określonej wartości `sourceData` zakotwiczonej na pierwszej komórce w tym zakresie.
`createTextFinder(findText)`	`TextFinder`	Tworzy eksplorator tekstu dla tego zakresu, który może znaleźć i zastąpić tekst w tym zakresie.
`deleteCells(shiftDimension)`	`void`	Usuwa ten zakres komórek.
`expandGroups()`	`Range`	Rozwija zwinięte grupy, których zakres lub element sterujący krzyżuje się z tym zakresem.
`getA1Notation()`	`String`	Zwraca opis ciągu w zakresie A1.
`getBackground()`	`String`	Zwraca kolor tła lewej górnej komórki zakresu (np. `'#ffffff'`).
`getBackgroundObject()`	`Color`	Zwraca kolor tła lewej górnej komórki zakresu.
`getBackgroundObjects()`	`Color[][]`	Zwraca kolory tła komórek w zakresie.
`getBackgrounds()`	`String[][]`	Zwraca kolory tła komórek w zakresie (na przykład `'#ffffff'`).
`getBandings()`	`Banding[]`	Zwraca wszystkie pasma zastosowane do dowolnej komórki w tym zakresie.
`getCell(row, column)`	`Range`	Zwraca daną komórkę w zakresie.
`getColumn()`	`Integer`	Zwraca pozycję początkową kolumny w tym zakresie.
`getDataRegion()`	`Range`	Zwraca kopię zakresu rozwiniętego w 4 kardynałach karnych `Direction`, aby uwzględnić wszystkie sąsiednie komórki z danymi.
`getDataRegion(dimension)`	`Range`	Zwraca kopię zakresu `Direction.UP` i `Direction.DOWN` (jeśli określony wymiar to `Dimension.ROWS`) lub `Direction.NEXT` (i `Direction.PREVIOUS`), jeśli wymiar (`Dimension.COLUMNS`).
`getDataSourceFormula()`	`DataSourceFormula`	Zwraca wartość `DataSourceFormula` dla pierwszej komórki w zakresie lub `null`, jeśli komórka nie zawiera formuły źródła danych.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Zwraca wartości `DataSourceFormula` w komórkach w zakresie.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródła danych, które nakładają się na zakres.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych, które nakładają się na zakres.
`getDataSourceUrl()`	`String`	Zwraca adres URL danych z tego zakresu, którego można używać do tworzenia wykresów i zapytań.
`getDataTable()`	`DataTable`	Zwraca dane wewnątrz tego obiektu jako tabelę danych.
`getDataTable(firstRowIsHeader)`	`DataTable`	Zwraca dane z tego zakresu jako tabelę danych.
`getDataValidation()`	`DataValidation`	Zwraca regułę sprawdzania poprawności danych dotyczącą lewej górnej komórki zakresu.
`getDataValidations()`	`DataValidation[][]`	Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Pobierz metadane dewelopera powiązane z tym zakresem.
`getDisplayValue()`	`String`	Zwraca wartość w lewym górnym rogu zakresu.
`getDisplayValues()`	`String[][]`	Zwraca prostokątną siatkę wartości dla tego zakresu.
`getFilter()`	`Filter`	Zwraca filtr w arkuszu, do którego należy ten zakres, lub `null`, jeśli w arkuszu nie ma filtra.
`getFontColorObject()`	`Color`	Zwraca kolor czcionki komórki w lewym górnym rogu zakresu.
`getFontColorObjects()`	`Color[][]`	Zwraca kolory czcionki komórek w zakresie.
`getFontFamilies()`	`String[][]`	Zwraca rodziny czcionek w zakresie.
`getFontFamily()`	`String`	Zwraca rodzinę czcionek w lewym górnym rogu zakresu.
`getFontLine()`	`String`	Pobiera styl linii komórki w lewym górnym rogu zakresu (`'underline'`, `'line-through'` lub `'none'`).
`getFontLines()`	`String[][]`	Pobiera styl linii komórek w zakresie (`'underline'`, `'line-through'` lub `'none'`).
`getFontSize()`	`Integer`	Zwraca rozmiar czcionki w punkcie pomiarowym komórki w lewym górnym rogu zakresu.
`getFontSizes()`	`Integer[][]`	Zwraca rozmiary czcionek w zakresie.
`getFontStyle()`	`String`	Zwraca styl czcionki (`'italic'` lub `'normal'`) komórki w lewym górnym rogu zakresu.
`getFontStyles()`	`String[][]`	Zwraca style czcionek w zakresie.
`getFontWeight()`	`String`	Zwraca grubość (normalną/pogrubioną) komórki w lewym górnym rogu zakresu.
`getFontWeights()`	`String[][]`	Zwraca grubość czcionki w zakresie.
`getFormula()`	`String`	Zwraca formułę (notację A1) do lewej górnej komórki zakresu lub pusty ciąg, jeśli komórka jest pusta lub nie zawiera formuły.
`getFormulaR1C1()`	`String`	Zwraca formułę (notację R1C1) danej komórki lub `null`, jeśli nie występuje.
`getFormulas()`	`String[][]`	Zwraca formuły (notację A1) komórek w zakresie.
`getFormulasR1C1()`	`String[][]`	Zwraca formuły (notację R1C1) komórek w zakresie.
`getGridId()`	`Integer`	Zwraca identyfikator siatki arkusza nadrzędnego zakresu.
`getHeight()`	`Integer`	Zwraca wysokość zakresu.
`getHorizontalAlignment()`	`String`	Zwraca poziome formatowanie tekstu (w lewo, do środka lub w prawo) w komórce w lewym górnym rogu zakresu.
`getHorizontalAlignments()`	`String[][]`	Zwraca poziome komórki komórek w zakresie.
`getLastColumn()`	`Integer`	Zwraca pozycję kolumny końcowej.
`getLastRow()`	`Integer`	Zwraca pozycję wiersza końcowego.
`getMergedRanges()`	`Range[]`	Zwraca tablicę obiektów `Range` reprezentujących komórki scalone, które znajdują się w pełni w bieżącym zakresie lub zawierają co najmniej 1 komórkę z bieżącego zakresu.
`getNextDataCell(direction)`	`Range`	Zaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w danym kierunku, która jest skrajem sąsiadującego zakresu komórek z danymi lub z krawędzią arkusza kalkulacyjnego w danym kierunku.
`getNote()`	`String`	Zwraca notatkę związaną z podanym zakresem.
`getNotes()`	`String[][]`	Zwraca notatki powiązane z komórkami w zakresie.
`getNumColumns()`	`Integer`	Zwraca liczbę kolumn z tego zakresu.
`getNumRows()`	`Integer`	Zwraca liczbę wierszy w tym zakresie.
`getNumberFormat()`	`String`	Uzyskaj formatowanie liczb lub dat w lewym górnym rogu wybranego zakresu.
`getNumberFormats()`	`String[][]`	Zwraca liczby lub formaty daty dla komórek w zakresie.
`getRichTextValue()`	`RichTextValue`	Zwraca wartość tekstu sformatowanego w lewym górnym rogu zakresu lub `null`, jeśli komórka nie jest tekstem.
`getRichTextValues()`	`RichTextValue[][]`	Zwraca wartości tekstu sformatowanego dla komórek w zakresie.
`getRow()`	`Integer`	Zwraca pozycję wiersza dla tego zakresu.
`getRowIndex()`	`Integer`	Zwraca pozycję wiersza dla tego zakresu.
`getSheet()`	`Sheet`	Zwraca arkusz, do którego należy ten zakres.
`getTextDirection()`	`TextDirection`	Zwraca kierunek tekstu w lewym górnym rogu zakresu.
`getTextDirections()`	`TextDirection[][]`	Zwraca kierunek tekstu dla komórek w zakresie.
`getTextRotation()`	`TextRotation`	Zwraca ustawienia rotacji tekstu w lewej górnej komórce zakresu.
`getTextRotations()`	`TextRotation[][]`	Zwraca ustawienia rotacji tekstu dla komórek w zakresie.
`getTextStyle()`	`TextStyle`	Zwraca styl tekstu dla lewej górnej komórki zakresu.
`getTextStyles()`	`TextStyle[][]`	Zwraca style tekstu dla komórek w zakresie.
`getValue()`	`Object`	Zwraca wartość lewej górnej komórki zakresu.
`getValues()`	`Object[][]`	Zwraca prostokątną siatkę wartości dla tego zakresu.
`getVerticalAlignment()`	`String`	Zwraca wyrównanie w pionie (górne/środkowe/dolne) komórki w lewym górnym rogu zakresu.
`getVerticalAlignments()`	`String[][]`	Zwraca pionowe wyrównanie komórek w zakresie.
`getWidth()`	`Integer`	Zwraca szerokość zakresu w kolumnach.
`getWrap()`	`Boolean`	Zwraca, czy tekst w komórce jest zawijany.
`getWrapStrategies()`	`WrapStrategy[][]`	Zwraca strategie zawijania tekstu do komórek w zakresie.
`getWrapStrategy()`	`WrapStrategy`	Zwraca strategię zawijania tekstu w lewym górnym rogu zakresu.
`getWraps()`	`Boolean[][]`	Zwraca, czy tekst w komórkach jest zawijany.
`insertCells(shiftDimension)`	`Range`	Wstawia puste komórki do tego zakresu.
`insertCheckboxes()`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie, ze skonfigurowanym ustawieniem `true` dla zaznaczonego i `false`.
`insertCheckboxes(checkedValue)`	`Range`	Wstawia pola wyboru w każdej komórce zakresu, ze skonfigurowaną niestandardową wartością zaznaczenia i pustym ciągiem znaków, aby odznaczyć.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie skonfigurowanych z wartościami niestandardowymi dla stanów zaznaczenia i odznaczeń.
`isBlank()`	`Boolean`	Zwraca wartość `true`, jeśli zakres jest pusty.
`isChecked()`	`Boolean`	Wskazuje, czy wszystkie komórki w zakresie mają pole wyboru „zaznaczone”.
`isEndColumnBounded()`	`Boolean`	Określa, czy koniec zakresu jest powiązany z konkretną kolumną.
`isEndRowBounded()`	`Boolean`	Określa, czy koniec zakresu jest powiązany z konkretnym wierszem.
`isPartOfMerge()`	`Boolean`	Zwraca wartość `true`, jeśli komórki w bieżącym zakresie nakładają się na komórki scalone.
`isStartColumnBounded()`	`Boolean`	Określa, czy początek zakresu jest powiązany z konkretną kolumną.
`isStartRowBounded()`	`Boolean`	Określa, czy początek zakresu jest powiązany z konkretnym wierszem.
`merge()`	`Range`	Scala komórki z zakresu w jeden blok.
`mergeAcross()`	`Range`	Scal komórki w zakresie z kolumn.
`mergeVertically()`	`Range`	Scala komórki w zakresie.
`moveTo(target)`	`void`	Wytnij i wklej z tego zakresu (zarówno format, jak i wartości) do zakresu docelowego.
`offset(rowOffset, columnOffset)`	`Range`	Zwraca nowy zakres odsunięty od podanego zakresu o podaną liczbę wierszy i kolumn (, która może być ujemna).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Zwraca nowy zakres w odniesieniu do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz od podanego wzrostu w komórkach.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Zwraca nowy zakres w stosunku do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz podaną wysokość i szerokość w komórkach.
`protect()`	`Protection`	Tworzy obiekt, który może chronić zakres przed edytowaniem przez użytkowników z odpowiednimi uprawnieniami.
`randomize()`	`Range`	Kolejność losowa wierszy w danym zakresie.
`removeCheckboxes()`	`Range`	Usuwa wszystkie pola wyboru z zakresu.
`removeDuplicates()`	`Range`	Usuwa wiersze z tego zakresu zawierające wartości będące duplikatami wartości z dowolnego poprzedniego wiersza.
`removeDuplicates(columnsToCompare)`	`Range`	Usuwa wiersze z tego zakresu, które zawierają wartości z określonych kolumn będące duplikatami wartości z dowolnego poprzedniego wiersza.
`setBackground(color)`	`Range`	Ustawia kolor tła wszystkich komórek w zakresie w notacji CSS (np. `'#ffffff'` lub `'white'`).
`setBackgroundObject(color)`	`Range`	Ustawia kolor tła wszystkich komórek w zakresie.
`setBackgroundObjects(color)`	`Range`	Ustawia prostokątną siatkę kolorów tła (musi pasować do wymiarów tego zakresu).
`setBackgroundRGB(red, green, blue)`	`Range`	Ustawia kolor tła, podając wartości RGB (liczby całkowite z zakresu od 0 do 255).
`setBackgrounds(color)`	`Range`	Ustawia prostokątną siatkę kolorów tła (musi pasować do wymiarów tego zakresu).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Określa właściwość obramowania.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Ustawia właściwość obramowania, która określa kolor lub styl.
`setDataValidation(rule)`	`Range`	Ustawia jedną regułę sprawdzania poprawności danych dla wszystkich komórek w zakresie.
`setDataValidations(rules)`	`Range`	Ustawia reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
`setFontColor(color)`	`Range`	Ustawia kolor czcionki w notacji CSS (np. `'#ffffff'` lub `'white'`).
`setFontColorObject(color)`	`Range`	Ustawia kolor czcionki dla wybranego zakresu.
`setFontColorObjects(colors)`	`Range`	Ustawia prostokątną siatkę kolorów (musi pasować do wymiarów tego zakresu).
`setFontColors(colors)`	`Range`	Ustawia prostokątną siatkę kolorów (musi pasować do wymiarów tego zakresu).
`setFontFamilies(fontFamilies)`	`Range`	Ustawia prostokątną siatkę z rodzinami czcionek (musi pasować do wymiarów w tym zakresie).
`setFontFamily(fontFamily)`	`Range`	Określa rodzinę czcionek, np. „render” lub „HGOOG”.
`setFontLine(fontLine)`	`Range`	Ustawia styl linii dla danego zakresu (`'underline'`, `'line-through'` lub `'none'`).
`setFontLines(fontLines)`	`Range`	Ustawia prostokątną siatkę stylów linii (musi pasować do wymiarów tego zakresu).
`setFontSize(size)`	`Range`	Ustawia rozmiar czcionki (rozmiar punktowy).
`setFontSizes(sizes)`	`Range`	Ustawia prostokątną siatkę rozmiarów czcionek (musi pasować do wymiarów w tym zakresie).
`setFontStyle(fontStyle)`	`Range`	Ustaw styl czcionki dla danego zakresu (`'italic'` lub `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Ustawia prostokątną siatkę stylów czcionek (musi pasować do wymiarów w tym zakresie).
`setFontWeight(fontWeight)`	`Range`	Ustaw grubość czcionki dla danego zakresu (normalna/pogrubiona).
`setFontWeights(fontWeights)`	`Range`	Ustawia prostokątną siatkę grubości czcionek (musi pasować do wymiarów tego zakresu).
`setFormula(formula)`	`Range`	Aktualizuje formułę dla tego zakresu.
`setFormulaR1C1(formula)`	`Range`	Aktualizuje formułę dla tego zakresu.
`setFormulas(formulas)`	`Range`	Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu).
`setFormulasR1C1(formulas)`	`Range`	Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu).
`setHorizontalAlignment(alignment)`	`Range`	Ustaw wyrównanie w poziomie (od lewej do prawej) w przypadku wybranego zakresu (w lewo, do środka lub w prawo).
`setHorizontalAlignments(alignments)`	`Range`	Ustawia prostokątną siatkę wyrównania w poziomie.
`setNote(note)`	`Range`	Przypisuje do notatki wartość.
`setNotes(notes)`	`Range`	Ustawia prostokątną siatkę notatek (musi pasować do wymiarów tego zakresu).
`setNumberFormat(numberFormat)`	`Range`	Ustawia liczbę lub format daty dla danego ciągu formatowania.
`setNumberFormats(numberFormats)`	`Range`	Ustawia prostokątną siatkę liczb lub formatów daty (musi pasować do wymiarów w tym zakresie).
`setRichTextValue(value)`	`Range`	Ustawia wartość RTF dla komórek w zakresie.
`setRichTextValues(values)`	`Range`	Ustawia prostokątną siatkę wartości tekstu sformatowanego.
`setShowHyperlink(showHyperlink)`	`Range`	Określa, czy zakres powinien wyświetlać hiperlinki.
`setTextDirection(direction)`	`Range`	Ustawia kierunek tekstowy dla komórek w zakresie.
`setTextDirections(directions)`	`Range`	Ustawia prostokątną siatkę tekstu.
`setTextRotation(degrees)`	`Range`	Określa ustawienia rotacji tekstu w komórkach zakresu.
`setTextRotation(rotation)`	`Range`	Określa ustawienia rotacji tekstu w komórkach zakresu.
`setTextRotations(rotations)`	`Range`	Ustawia prostokątną siatkę rotacji tekstu.
`setTextStyle(style)`	`Range`	Ustawia styl tekstu w komórkach zakresu.
`setTextStyles(styles)`	`Range`	Ustawia prostokątną siatkę stylów tekstu.
`setValue(value)`	`Range`	Określa wartość zakresu.
`setValues(values)`	`Range`	Ustawia prostokątną siatkę wartości (musi pasować do wymiarów tego zakresu).
`setVerticalAlignment(alignment)`	`Range`	Ustaw wyrównanie w pionie (od góry do dołu) dla wybranego zakresu (góra/środek/dół).
`setVerticalAlignments(alignments)`	`Range`	Ustawia prostokątną siatkę wyrównań w pionie (musi pasować do wymiarów tego zakresu).
`setVerticalText(isVertical)`	`Range`	Określa, czy tekst dla komórek w zakresie ma być ułożony w stos.
`setWrap(isWrapEnabled)`	`Range`	Ustaw zawijanie komórki do podanego zakresu.
`setWrapStrategies(strategies)`	`Range`	Ustawia prostokątną siatkę strategii zawijania.
`setWrapStrategy(strategy)`	`Range`	Ustawia strategię zawijania tekstu w komórkach zakresu.
`setWraps(isWrapEnabled)`	`Range`	Ustawia prostokątną siatkę zawijania słów (musi pasować do wymiarów tego zakresu).
`shiftColumnGroupDepth(delta)`	`Range`	Zmienia głębokość grupowania zakresu o określoną kwotę.
`shiftRowGroupDepth(delta)`	`Range`	Zmienia głębokość grupowania zakresu o określoną kwotę.
`sort(sortSpecObj)`	`Range`	Sortuje komórki z danego zakresu według kolumny i kolejności.
`splitTextToColumns()`	`void`	Dzieli kolumnę tekstu na wiele kolumn na podstawie automatycznego separatora.
`splitTextToColumns(delimiter)`	`void`	Dzieli kolumnę tekstu na kolumny, używając określonego ciągu jako niestandardowego separatora.
`splitTextToColumns(delimiter)`	`void`	Dzieli kolumnę tekstu na kilka kolumn na podstawie określonego separatora.
`trimWhitespace()`	`Range`	Służy do wycinania odstępów (np. spacji, kart lub nowych wierszy) w każdej komórce zakresu.
`uncheck()`	`Range`	Zmień stan pól wyboru na „odznaczone”.

Metody wycofane

Metoda	Zwracany typ	Krótki opis
`getFontColor()`	`String`	Zwraca kolor czcionki komórki w lewym górnym rogu zakresu w notacji CSS (np. `'#ffffff'` lub `'white'`).
`getFontColors()`	`String[][]`	Zwraca kolory czcionki komórek w zakresie w notacji CSS (np. `'#ffffff'` lub `'white'`).

Szczegółowa dokumentacja

`activate()`

Ustawia określony zakres jako active range, przy czym lewa górna komórka w zakresie jest ustawiona jako current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

Powrót

Range – ten zakres do tworzenia łańcuchów.

`activateAsCurrentCell()`

Ustawia określoną komórkę jako current cell.

Jeśli określona komórka występuje w istniejącym zakresie, zakres ten stanie się aktywnym zakresem, w którym komórka będzie tą bieżącą.

Jeśli określonej komórki nie ma w żadnym istniejącym zakresie, zaznaczenie zostanie usunięte, a komórka stanie się bieżącą i zakresem aktywnym.

Uwaga: podany Range musi składać się z jednej komórki. W przeciwnym razie zwróci wyjątek.

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key)`

Dodaje do zakresu metadane dewelopera z podanym kluczem.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz dla nowych metadanych dewelopera.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, visibility)`

Dodaje do zakresu metadane dewelopera z określonym kluczem.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz dla nowych metadanych dewelopera.
`visibility`	`DeveloperMetadataVisibility`	Widoczność nowych metadanych dewelopera.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value)`

Dodaje do zakresu metadane dewelopera z określonym kluczem i wartością.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz dla nowych metadanych dewelopera.
`value`	`String`	Wartość nowych metadanych dewelopera.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value, visibility)`

Dodaje do zakresu metadane dewelopera z określonym kluczem, wartością i widocznością.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz dla nowych metadanych dewelopera.
`value`	`String`	Wartość nowych metadanych dewelopera.
`visibility`	`DeveloperMetadataVisibility`	Widoczność nowych metadanych dewelopera.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyColumnBanding()`

Stosuje do zakresu domyślny motyw pasma kolumn. Domyślnie opaski mają nagłówek i brak koloru stopki.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Powrót

Banding – nowy pas.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyColumnBanding(bandingTheme)`

Stosuje do zakresu wybrany motyw pasma kolumnowego. Domyślnie opaski mają kolor nagłówka i bez stopki.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Parametry

Nazwa	Typ	Opis
`bandingTheme`	`BandingTheme`	Motyw koloru, który zostanie zastosowany do kolumn w zakresie.

Powrót

Banding – nowy pas.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Stosuje określony zakres pasma do kolumny do zakresu z określonymi ustawieniami nagłówka i stopki.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

Parametry

Nazwa	Typ	Opis
`bandingTheme`	`BandingTheme`	Motyw koloru, który zostanie zastosowany do kolumn w zakresie.
`showHeader`	`Boolean`	Jeśli ustawiona jest wartość `true`, kolor nagłówka motywu pasma jest stosowany do pierwszej kolumny.
`showFooter`	`Boolean`	Jeśli ustawiona jest wartość `true`, kolor stopki pasma motywu jest stosowany w ostatniej kolumnie.

Powrót

Banding – nowy pas.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyRowBanding()`

Stosuje domyślny zakres pasma wierszy do zakresu. Domyślnie opaski mają nagłówek i brak koloru stopki.

Powrót

Banding – nowy pas.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyRowBanding(bandingTheme)`

Stosuje do zakresu określony motyw pasma wiersza. Domyślnie opaski mają nagłówek i brak koloru stopki.

Parametry

Nazwa	Typ	Opis
`bandingTheme`	`BandingTheme`	Motyw koloru, który zostanie zastosowany do wierszy w zakresie.

Powrót

Banding – nowy pas.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Stosuje określony zakres opaski do wiersza do zakresu z określonymi ustawieniami nagłówka i stopki.

Parametry

Nazwa	Typ	Opis
`bandingTheme`	`BandingTheme`	Motyw koloru, który zostanie zastosowany do wierszy w zakresie.
`showHeader`	`Boolean`	W przypadku wartości `true` w pierwszym wierszu zostanie zastosowany kolor nagłówka motywu pasma.
`showFooter`	`Boolean`	W przypadku wartości `true` w ostatnim wierszu zostanie zastosowany kolor stopki motywu.

Powrót

Banding – nowy pas.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoFill(destination, series)`

Wypełnia pole destinationRange danymi na podstawie danych z tego zakresu. Nowe wartości są również określane przez podany typ series. Zakres docelowy musi zawierać go i rozszerzać tylko w jednym kierunku. Na przykład ten element A1:A20 wypełnia serię rosnących liczb na podstawie bieżących wartości A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres automatycznego uzupełniania wartościami. Zakres docelowy powinien zawierać ten zakres i rozszerzać go tylko w jednym kierunku (w górę, w dół, w lewo lub w prawo).
`series`	`AutoFillSeries`	Typ serii autoFill, który powinien być używany do obliczania nowych wartości. Efekt z tej serii różni się w zależności od typu i liczby danych źródłowych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoFillToNeighbor(series)`

Oblicza zakres do wypełnienia nowymi danymi na podstawie sąsiadujących komórek i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych zawartych w tym zakresie. Nowe wartości są też określane przez określony typ series.

Obliczony zakres docelowy uwzględnia otaczające dane dane, aby ustalić, gdzie należy wstawić nowe wartości. Jeśli istnieją dane po lewej lub prawej stronie kolumny, która jest wypełniana automatycznie, nowe wartości obejmują tylko te sąsiednie dane.

Jeśli np. pole A1:A20 jest wypełnione ciągiem rosnącym i ta metoda jest wywoływana w zakresie B1:B4, który zawiera serię dat, nowe wartości są wstawiane tylko w polu B5:B20. Dzięki temu nowe wartości „przyklejają” do komórek zawierających wartości w kolumnie A.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parametry

Nazwa	Typ	Opis
`series`	`AutoFillSeries`	Typ serii autoFill, który powinien być używany do obliczania nowych wartości. Efekt z tej serii różni się w zależności od typu i liczby danych źródłowych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`breakApart()`

Rozdziel komórki wielokolumnowe w zakresie na poszczególne komórki.

Wywołanie tej funkcji z zakresu jest równoznaczne z wybraniem zakresu i kliknięciem Format -> Scal -> Rozdziel.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`canEdit()`

Określa, czy użytkownik ma uprawnienia do edytowania każdej komórki w zakresie. Właściciel arkusza kalkulacyjnego może zawsze edytować chronione zakresy i arkusze.

Powrót

Boolean – true, jeśli użytkownik ma uprawnienia do edytowania każdej komórki w zakresie. W przeciwnym razie false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`check()`

Zmienia stan pól wyboru w zakresie na „zaznaczone”. Ignoruje komórki z zakresu, które obecnie nie zawierają żadnej zaznaczonej lub niezaznaczonej wartości.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear()`

Usuwa zakres treści i formatów.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear(options)`

Usuwa zakres treści, format, reguły sprawdzania poprawności danych i komentarze określone za pomocą podanych opcji zaawansowanych. Domyślnie wszystkie dane są usuwane.

// The code below clears range C2:G8 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Obiekt JavaScript określający parametry zaawansowane (wymienione poniżej).

Parametry zaawansowane

Nazwa	Typ	Opis
`commentsOnly`	`Boolean`	Czy usunąć tylko komentarze
`contentsOnly`	`Boolean`	Określa, czy chcesz wyczyścić tylko całą zawartość.
`formatOnly`	`Boolean`	Określa, czy chcesz wyczyścić tylko format. Pamiętaj, że w ten sposób wyczyścisz też reguły sprawdzania poprawności danych.
`validationsOnly`	`Boolean`	Określa, czy chcesz usunąć tylko reguły sprawdzania poprawności danych.
`skipFilteredRows`	`Boolean`	Czy nie chcesz czyścić odfiltrowanych wierszy?

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearContent()`

Czyści zawartość zakresu bez zmiany formatowania.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearDataValidations()`

Usuwa reguły weryfikacji danych dla danego zakresu.

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearFormat()`

Usuwa formatowanie dla tego zakresu.

Powoduje to wyczyszczenie formatowania tekstu w komórce lub zakresie komórek, ale nie powoduje zresetowania żadnych reguł formatowania liczb.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearNote()`

Usuwa notatkę z danej komórki lub komórki.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`collapseGroups()`

Zwija wszystkie grupy, które w całości znajdują się w zakresie. Jeśli żadna grupa nie mieści się w pełnym zakresie, najgłębsza grupa rozwinięta, która jest częścią zakresu, jest zwinięta.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`

Skopiuj formatowanie zakresu do podanej lokalizacji. Jeśli miejsce docelowe jest większe lub mniejsze niż zakres źródłowy, źródło jest wielokrotnie powtarzane lub skracane. Pamiętaj, że ta metoda tylko kopiuje formatowanie.

Szczegółowy opis parametru gridId znajdziesz na stronie getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

Parametry

Nazwa	Typ	Opis
`gridId`	`Integer`	Unikalny identyfikator arkusza w arkuszu kalkulacyjnym, niezależnie od swojej pozycji.
`column`	`Integer`	Pierwsza kolumna zakresu docelowego.
`columnEnd`	`Integer`	Końcowa wartość zakresu docelowego.
`row`	`Integer`	Wiersz początkowy zakresu docelowego.
`rowEnd`	`Integer`	Wiersz końcowy zakresu docelowego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

getGridId()

`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Arkusz docelowy.
`column`	`Integer`	Pierwsza kolumna zakresu docelowego.
`columnEnd`	`Integer`	Końcowa wartość zakresu docelowego.
`row`	`Integer`	Wiersz początkowy zakresu docelowego.
`rowEnd`	`Integer`	Wiersz końcowy zakresu docelowego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(destination)`

Kopiuje dane z zakresu do innego zakresu komórek. Kopiowane są zarówno wartości, jak i formatowanie.

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres docelowy, do którego należy skopiować dane. Tylko pozycja w lewym górnym rogu jest istotna.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(destination, copyPasteType, transposed)`

Kopiuje dane z zakresu do innego zakresu komórek.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres docelowy, do którego należy skopiować dane. Tylko pozycja w lewym górnym rogu jest istotna.
`copyPasteType`	`CopyPasteType`	Typ określający sposób wklejania zawartości zakresu do miejsca docelowego.
`transposed`	`Boolean`	Określa, czy zakres powinien zostać wklejony w orientacji transkodowanej.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(destination, options)`

Kopiuje dane z zakresu do innego zakresu komórek. Domyślnie kopiowane są zarówno wartości, jak i formatowanie, ale można je zastąpić za pomocą zaawansowanych argumentów.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres docelowy, do którego należy skopiować dane. Tylko pozycja w lewym górnym rogu jest istotna.
`options`	`Object`	Obiekt JavaScript określający parametry zaawansowane (wymienione poniżej).

Parametry zaawansowane

Nazwa	Typ	Opis
`formatOnly`	`Boolean`	oznacza, że kopiowany jest tylko format
`contentsOnly`	`Boolean`	oznacza, że kopiowana jest tylko treść

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`

Skopiuj zawartość zakresu do podanej lokalizacji. Jeśli miejsce docelowe jest większe lub mniejsze niż zakres źródłowy, źródło jest wielokrotnie powtarzane lub skracane.

Szczegółowy opis parametru gridId znajdziesz na stronie getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

Parametry

Nazwa	Typ	Opis
`gridId`	`Integer`	Unikalny identyfikator arkusza w arkuszu kalkulacyjnym, niezależnie od swojej pozycji.
`column`	`Integer`	Pierwsza kolumna zakresu docelowego.
`columnEnd`	`Integer`	Końcowa wartość zakresu docelowego.
`row`	`Integer`	Wiersz początkowy zakresu docelowego.
`rowEnd`	`Integer`	Wiersz końcowy zakresu docelowego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

getGridId()

`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`

Skopiuj zawartość zakresu do podanej lokalizacji. Jeśli miejsce docelowe jest większe lub mniejsze niż zakres źródłowy, źródło jest wielokrotnie powtarzane lub skracane.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Arkusz docelowy.
`column`	`Integer`	Pierwsza kolumna zakresu docelowego.
`columnEnd`	`Integer`	Końcowa wartość zakresu docelowego.
`row`	`Integer`	Wiersz początkowy zakresu docelowego.
`rowEnd`	`Integer`	Wiersz końcowy zakresu docelowego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDataSourcePivotTable(dataSource)`

Tworzy pustą tabelę przestawną źródła danych, która jest zakotwiczona w pierwszej komórce tego zakresu.

Ten przykład pokazuje, jak utworzyć i skonfigurować nową tabelę przestawną źródła danych

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

Parametry

Nazwa	Typ	Opis
`dataSource`	`DataSource`	Źródło danych, z którego chcesz utworzyć tabelę przestawną.

Powrót

DataSourcePivotTable – nowo utworzona tabela przestawna źródła danych,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDataSourceTable(dataSource)`

Powoduje utworzenie pustej tabeli źródła danych, która jest zakotwiczona w pierwszej komórce tego zakresu.

Ten przykład pokazuje, jak utworzyć i skonfigurować nową tabelę źródeł danych.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

Parametry

Nazwa	Typ	Opis
`dataSource`	`DataSource`	Źródło danych, z którego chcesz utworzyć tabelę przestawną.

Powrót

DataSourceTable – nowo utworzona tabela źródeł danych;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDeveloperMetadataFinder()`

Zwraca DeveloperMetadataFinderApi do wyszukiwania metadanych dewelopera w zakresie. Metadane należą do tego zakresu, tylko jeśli są w całości zawarte w nim. Na przykład metadane powiązane z wierszem „3:3” nie należą do zakresu „A1:D5”, ale są w zakresie „1:5”.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Powrót

DeveloperMetadataFinder – narzędzie do wyszukiwania metadanych dla deweloperów, które umożliwia wyszukiwanie metadanych z tego zakresu.

`createFilter()`

Tworzy filtr i stosuje go do określonego zakresu w arkuszu. W arkuszu nie można utworzyć więcej niż 1 filtra. Aby uzyskać dostęp do filtra i go zmodyfikować, użyj opcji getFilter() lub Sheet.getFilter().

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}

Użyj tej metody, aby utworzyć filtry dla Grid arkuszy (domyślnego typu). Arkusze siatki to arkusze, które nie są połączone z bazą danych. Aby utworzyć inne rodzaje filtrów, zapoznaj się z tymi wskazówkami:

Tworzenie filtra tabeli przestawnej przy użyciu obiektu PivotTable.addFilter(sourceDataColumn, filterCriteria)
Utwórz filtr dla arkusza połączonego z bazą danych w DataSourceSheet.addFilter(columnName, filterCriteria)
Utwórz filtr tabeli przestawnej połączonej z bazą danych DataSourcePivotTable.addFilter(columnName, filterCriteria)

Powrót

Filter – nowy filtr.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createPivotTable(sourceData)`

Tworzy pustą tabelę przestawną z określonej wartości sourceData zakotwiczonej na pierwszej komórce w tym zakresie.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

Parametry

Nazwa	Typ	Opis
`sourceData`	`Range`	Dane, na podstawie których ma zostać utworzona tabela przestawna.

Powrót

PivotTable – nowo utworzony element PivotTable.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createTextFinder(findText)`

Tworzy eksplorator tekstu dla tego zakresu, który może znaleźć i zastąpić tekst w tym zakresie.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

Parametry

Nazwa	Typ	Opis
`findText`	`String`	Tekst do wyszukania.

Powrót

TextFinder – TextFinder zakresu

`deleteCells(shiftDimension)`

Usuwa ten zakres komórek. Istniejące dane w arkuszu wzdłuż podanego wymiaru zostaną przeniesione do usuniętego zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parametry

Nazwa	Typ	Opis
`shiftDimension`	`Dimension`	Wymiar, który służy do przenoszenia istniejących danych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`expandGroups()`

Rozwija zwinięte grupy, których zakres lub element sterujący krzyżuje się z tym zakresem. Lokalizacja przełącznika kontrolnego to indeks, w którym wyświetlany jest przełącznik – bezpośrednio przed grupą lub po niej – w zależności od ustawień. Jeśli w tej samej lokalizacji jest więcej niż 1 grupa, grupa ta jest rozszerzana.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getA1Notation()`

Zwraca opis ciągu w zakresie A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

Powrót

String – opis ciągu w notacji A1;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackground()`

Zwraca kolor tła lewej górnej komórki zakresu (np. '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

Powrót

String – kod koloru tła,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackgroundObject()`

Zwraca kolor tła lewej górnej komórki zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Powrót

Color – kolor tła lewej górnej komórki zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackgroundObjects()`

Zwraca kolory tła komórek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

Powrót

Color[][] – dwuwymiarowy zestaw kolorów tła,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackgrounds()`

Zwraca kolory tła komórek w zakresie (na przykład '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowy zestaw kodów kolorów tła.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBandings()`

Zwraca wszystkie pasma zastosowane do dowolnej komórki w tym zakresie.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Powrót

Banding[] – wszystkie pasma zastosowane do dowolnej komórki w tym zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCell(row, column)`

Zwraca daną komórkę w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parametry

Nazwa	Typ	Opis
`row`	`Integer`	Wiersz komórki w stosunku do zakresu.
`column`	`Integer`	Kolumna komórki w stosunku do zakresu.

Powrót

Range – zakres zawierający jedną komórkę z określonymi współrzędnymi.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumn()`

Zwraca pozycję początkową kolumny w tym zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

Powrót

Integer – początkową wartość kolumny w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRegion()`

Zwraca kopię zakresu rozwiniętego w 4 kardynałach karnych Direction, aby uwzględnić wszystkie sąsiednie komórki z danymi. Jeśli zakres jest otoczony pustymi komórkami, nieuwzględniającymi tych przekątnych, zwracany jest sam zakres. Działa to podobnie jak wybieranie zakresu w edytorze i wpisywanie Ctrl+A.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

Powrót

Range – region danych lub zakres całego arkusza kalkulacyjnego;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRegion(dimension)`

Zwraca kopię zakresu Direction.UP i Direction.DOWN (jeśli określony wymiar to Dimension.ROWS) lub Direction.NEXT (i Direction.PREVIOUS), jeśli wymiar (Dimension.COLUMNS). Zasięg tego zakresu zależy od wykrywania danych obok zakresu, który jest uporządkowany jak tabela. Rozszerzony zakres obejmuje wszystkie sąsiednie komórki z danymi w określonym wymiarze, w tym z granicami tabeli. Jeśli pierwotny zakres zostanie otoczony pustymi komórkami w określonym wymiarze, zostanie zwrócony sam zakres. Ta metoda jest podobna do wyboru zakresu i wpisywania Ctrl+Space w przypadku kolumn lub Shift+Space w przypadku wierszy w edytorze.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

Parametry

Nazwa	Typ	Opis
`dimension`	`Dimension`	Wymiar, w którym można rozszerzyć zakres.

Powrót

Range – region zakresu danych lub zakres obejmujący każdą kolumnę lub każdy wiersz objęty pierwotnym zakresem;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormula()`

Zwraca wartość DataSourceFormula dla pierwszej komórki w zakresie lub null, jeśli komórka nie zawiera formuły źródła danych.

Powrót

DataSourceFormula – DataSourceFormula komórki.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormulas()`

Zwraca wartości DataSourceFormula w komórkach w zakresie.

Powrót

DataSourceFormula[] – tablica DataSourceFormula.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourcePivotTables()`

Pobiera wszystkie tabele przestawne źródła danych, które nakładają się na zakres.

Powrót

DataSourcePivotTable[] – lista tabel przestawnych źródeł danych,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceTables()`

Pobiera wszystkie tabele źródeł danych, które nakładają się na zakres.

Powrót

DataSourceTable[] – lista tabel źródeł danych,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceUrl()`

Zwraca adres URL danych z tego zakresu, którego można używać do tworzenia wykresów i zapytań.

Kod.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

wykres kołowy.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

Powrót

String – URL dla tego zakresu jako źródła danych, które można przekazać do innych interfejsów API, np. wykresów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataTable()`

Zwraca dane wewnątrz tego obiektu jako tabelę danych.

Powrót

DataTable – dane w formie tabeli danych.

`getDataTable(firstRowIsHeader)`

Zwraca dane z tego zakresu jako tabelę danych.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

Parametry

Nazwa	Typ	Opis
`firstRowIsHeader`	`Boolean`	Określa, czy pierwszy wiersz ma być traktowany jako nagłówek.

Powrót

DataTable – dane w formie tabeli danych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataValidation()`

Zwraca regułę sprawdzania poprawności danych dotyczącą lewej górnej komórki zakresu. Jeśli weryfikacja danych nie została ustawiona w komórce, ta metoda zwraca null.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Powrót

DataValidation – reguła sprawdzania poprawności danych, która znajduje się w lewym górnym rogu zakresu;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataValidations()`

Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie. Jeśli weryfikacja danych nie została ustawiona w danej komórce, ta metoda zwraca wartość null dla pozycji tej komórki w tablicy.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Powrót

DataValidation[][] – dwuwymiarowa tablica reguł weryfikacji danych powiązanych z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDeveloperMetadata()`

Pobierz metadane dewelopera powiązane z tym zakresem.

Powrót

DeveloperMetadata[] – metadane dewelopera powiązane z tym zakresem.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDisplayValue()`

Zwraca wartość w lewym górnym rogu zakresu. Wartość to String. Wyświetlana wartość uwzględnia formatowanie formatowania daty, godziny i waluty, w tym formaty stosowane automatycznie przez ustawienie regionalne arkusza kalkulacyjnego. Puste komórki zwracają pusty ciąg.

Powrót

String – wartość wyświetlana w tej komórce.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDisplayValues()`

Zwraca prostokątną siatkę wartości dla tego zakresu.

Zwraca dwuwymiarową tablicę wyświetlanych wartości, indeksowanych według wiersza, a następnie według kolumny. Wartości to obiekty String. Wyświetlana wartość uwzględnia formatowanie daty, godziny i waluty, w tym formaty stosowane automatycznie przez ustawienie regionalne arkusza kalkulacyjnego. Puste komórki są reprezentowane przez pusty ciąg znaków w tablicy. Pamiętaj, że chociaż indeks zakresu zaczyna się od 1, 1, tablica JavaScript jest indeksowana z [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Powrót

String[][] – dwuwymiarowa tablica wartości,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFilter()`

Zwraca filtr w arkuszu, do którego należy ten zakres, lub null, jeśli w arkuszu nie ma filtra.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

Powrót

Filter – filtr.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontColorObject()`

Zwraca kolor czcionki komórki w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

Powrót

Color – kolor czcionki w lewym górnym rogu zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontColorObjects()`

Zwraca kolory czcionki komórek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

Powrót

Color[][] – dwuwymiarowa tablica kolorów czcionki powiązana z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontFamilies()`

Zwraca rodziny czcionek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica rodzin czcionek powiązana z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontFamily()`

Zwraca rodzinę czcionek w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

Powrót

String – rodzina czcionek w komórce.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontLine()`

Pobiera styl linii komórki w lewym górnym rogu zakresu ('underline', 'line-through' lub 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

Powrót

String – linia czcionek;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontLines()`

Pobiera styl linii komórek w zakresie ('underline', 'line-through' lub 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica linii czcionek powiązana z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontSize()`

Zwraca rozmiar czcionki w punkcie pomiarowym komórki w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

Powrót

Integer – rozmiar czcionki w punktach;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontSizes()`

Zwraca rozmiary czcionek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

Integer[][] – dwuwymiarowa tablica rozmiarów czcionek związanych z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontStyle()`

Zwraca styl czcionki ('italic' lub 'normal') komórki w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

Powrót

String – styl czcionki tekstu w komórce;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontStyles()`

Zwraca style czcionek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica stylów czcionek powiązana z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontWeight()`

Zwraca grubość (normalną/pogrubioną) komórki w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

Powrót

String – waga czcionki tekstu w komórce,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontWeights()`

Zwraca grubość czcionki w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa waga czcionki tekstu powiązanego z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormula()`

Zwraca formułę (notację A1) do lewej górnej komórki zakresu lub pusty ciąg, jeśli komórka jest pusta lub nie zawiera formuły.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

Powrót

String – formuła komórki.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormulaR1C1()`

Zwraca formułę (notację R1C1) danej komórki lub null, jeśli nie występuje.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

Powrót

String – formuła w zapisie R1C1.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormulas()`

Zwraca formuły (notację A1) komórek w zakresie. Wpisy w tablicy 2D są pustymi ciągami komórek bez formuły.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa formuła w formie ciągu,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormulasR1C1()`

Zwraca formuły (notację R1C1) komórek w zakresie. Pozycje w tablicy 2D dotyczą komórek bez formuły: null.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa formuła w notacji R1C1.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getGridId()`

Zwraca identyfikator siatki arkusza nadrzędnego zakresu. Identyfikatory są losowymi nieujemnymi wartościami całkowitymi.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

Powrót

Integer – identyfikator siatki arkusza nadrzędnego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeight()`

Zwraca wysokość zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

Powrót

Integer – wysokość zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHorizontalAlignment()`

Zwraca poziome formatowanie tekstu (w lewo, do środka lub w prawo) w komórce w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

Powrót

String – wyrównanie tekstu w komórce;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHorizontalAlignments()`

Zwraca poziome komórki komórek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica poziomego wyrównania tekstu powiązanego z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastColumn()`

Zwraca pozycję kolumny końcowej.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

Powrót

Integer – położenie kolumny na końcu zakresu w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastRow()`

Zwraca pozycję wiersza końcowego.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

Powrót

Integer – pozycja na końcu zakresu w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMergedRanges()`

Zwraca tablicę obiektów Range reprezentujących komórki scalone, które znajdują się w pełni w bieżącym zakresie lub zawierają co najmniej 1 komórkę z bieżącego zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

Powrót

Range[] – tablica Range obiektów reprezentujących scalone komórki, które nakładają się na zakres.

`getNextDataCell(direction)`

Zaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w danym kierunku, która jest skrajem sąsiadującego zakresu komórek z danymi lub z krawędzią arkusza kalkulacyjnego w danym kierunku. Odpowiada to wpisaniu w edytorze Ctrl+[arrow key].

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

Parametry

Nazwa	Typ	Opis
`direction`	`Direction`	Kierunek, w którym ma zostać wyszukana komórka brzegowa regionu danych.

Powrót

Range – komórka brzegowa regionu danych lub komórka brzegowa arkusza kalkulacyjnego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNote()`

Zwraca notatkę związaną z podanym zakresem.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

Powrót

String – notatka powiązana z daną komórką.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNotes()`

Zwraca notatki powiązane z komórkami w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowy układ notatek powiązanych z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumColumns()`

Zwraca liczbę kolumn z tego zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

Powrót

Integer – liczba kolumn w tym zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumRows()`

Zwraca liczbę wierszy w tym zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

Powrót

Integer – liczba wierszy w tym zakresie,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumberFormat()`

Uzyskaj formatowanie liczb lub dat w lewym górnym rogu wybranego zakresu. Zwrócone wzorce formatów są opisane w dokumentacji interfejsu Sheets API.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

Powrót

String – format liczbowy lewego górnego rogu zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumberFormats()`

Zwraca liczby lub formaty daty dla komórek w zakresie. Zwrócone wzorce formatów są opisane w dokumentacji interfejsu Sheets API.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica formatów liczb.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRichTextValue()`

Zwraca wartość tekstu sformatowanego w lewym górnym rogu zakresu lub null, jeśli komórka nie jest tekstem.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

Powrót

RichTextValue – wartość tekstu sformatowanego u góry po lewej stronie w zakresie lub null, jeśli komórka nie jest tekstem.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRichTextValues()`

Zwraca wartości tekstu sformatowanego dla komórek w zakresie.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

Powrót

RichTextValue[][] – dwuwymiarowa tablica wartości tekstowych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRow()`

Zwraca pozycję wiersza dla tego zakresu. Jest taka sama jak funkcja getRowIndex().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRow());

Powrót

Integer – położenie wiersza zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowIndex()`

Zwraca pozycję wiersza dla tego zakresu. Jest taka sama jak w metodzie getRow().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

Powrót

Integer – położenie wiersza zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

getRow()

`getSheet()`

Zwraca arkusz, do którego należy ten zakres.

Powrót

Sheet – arkusz, do którego należy ten zakres.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextDirection()`

Zwraca kierunek tekstu w lewym górnym rogu zakresu. Zwraca wartość null, jeśli kierunek tekstu komórki jest wykrywany za pomocą automatycznego wykrywania.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

Powrót

TextDirection – kierunek tekstu w lewej górnej komórce zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextDirections()`

Zwraca kierunek tekstu dla komórek w zakresie. Pozycje w tablicy 2D stanowią null dla komórek korzystających z automatycznego wykrywania.

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

Powrót

TextDirection[][] – dwuwymiarowa tablica wskazówek tekstowych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextRotation()`

Zwraca ustawienia rotacji tekstu w lewej górnej komórce zakresu.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

Powrót

TextRotation – ustawienia rotacji tekstu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextRotations()`

Zwraca ustawienia rotacji tekstu dla komórek w zakresie.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

Powrót

TextRotation[][] – dwuwymiarowy obrót tekstu powiązany z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextStyle()`

Zwraca styl tekstu dla lewej górnej komórki zakresu.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

Powrót

TextStyle – styl tekstu w lewym górnym rogu zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextStyles()`

Zwraca style tekstu dla komórek w zakresie.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

Powrót

TextStyle[][] – dwuwymiarowa tablica stylów tekstu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getValue()`

Zwraca wartość lewej górnej komórki zakresu. Może to być typ Number, Boolean, Date lub String, w zależności od wartości w komórce. Puste komórki zwracają pusty ciąg.

Powrót

Object – wartość w komórce.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getValues()`

Zwraca prostokątną siatkę wartości dla tego zakresu.

Zwraca dwuwymiarową tablicę wartości, indeksowaną według wiersza, a następnie według kolumny. W zależności od wartości komórki mogą to być wartości Number, Boolean, Date lub String. Puste komórki są reprezentowane przez pusty ciąg znaków w tablicy. Pamiętaj, że chociaż indeks zakresu zaczyna się od 1, 1, tablica JavaScript jest indeksowana z [0][0].

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

W aplikacjach internetowych wartość Date nie jest parametrem prawnym. getValues() nie zwraca danych do aplikacji internetowej, jeśli zakres zawiera komórkę z wartością Date. Zamiast tego przekonwertuj wszystkie wartości pobrane z arkusza na obsługiwany element podstawowy JavaScript, np. Number, Boolean lub String.

Powrót

Object[][] – dwuwymiarowa tablica wartości,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getVerticalAlignment()`

Zwraca wyrównanie w pionie (górne/środkowe/dolne) komórki w lewym górnym rogu zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

Powrót

String – wyrównanie tekstu do komórki w pionie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getVerticalAlignments()`

Zwraca pionowe wyrównanie komórek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica pionowego wyrównania tekstu powiązanego z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWidth()`

Zwraca szerokość zakresu w kolumnach.

Powrót

Integer – liczba kolumn w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWrap()`

Zwraca, czy tekst w komórce jest zawijany. Aby uzyskać bardziej szczegółową strategię dodawania tagów, użyj zasady getWrapStrategy().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

Powrót

Boolean – wskazuje, czy tekst w tej komórce ma się zawijać.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWrapStrategies()`

Zwraca strategie zawijania tekstu do komórek w zakresie.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

Powrót

WrapStrategy[][] – dwuwymiarowy zestaw strategii zawijania tekstu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWrapStrategy()`

Zwraca strategię zawijania tekstu w lewym górnym rogu zakresu.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

Powrót

WrapStrategy – strategia zawijania tekstu w lewym górnym rogu zakresu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWraps()`

Zwraca, czy tekst w komórkach jest zawijany. Aby uzyskać bardziej szczegółową strategię dodawania tagów, użyj zasady getWrapStrategies().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

Powrót

Boolean[][] – dwuwymiarowa tablica pionowego wyrównania tekstu powiązanego z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCells(shiftDimension)`

Wstawia puste komórki do tego zakresu. Nowe komórki zachowują całe formatowanie, które wcześniej znajdowały się w tym zakresie. Istniejące dane w arkuszu wzdłuż podanego wymiaru zostaną odsunięte od wstawionego zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parametry

Nazwa	Typ	Opis
`shiftDimension`	`Dimension`	Wymiar, który służy do przenoszenia istniejących danych.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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, ze skonfigurowanym ustawieniem true dla zaznaczonego i false. Ustawia wartość wszystkich komórek w zakresie na false.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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, ze skonfigurowaną niestandardową wartością zaznaczenia i pustym ciągiem znaków, aby odznaczyć. Ustawia wartość w komórce na zakres pusty.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

Parametry

Nazwa	Typ	Opis
`checkedValue`	`Object`	Wartość sprawdzania poprawności danych pola wyboru.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 skonfigurowanych z wartościami niestandardowymi dla stanów zaznaczenia i odznaczeń. Ustawia niestandardową wartość niezaznaczonego zakresu w każdej komórce zakresu.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

Parametry

Nazwa	Typ	Opis
`checkedValue`	`Object`	Wartość sprawdzania poprawności danych pola wyboru.
`uncheckedValue`	`Object`	Niezaznaczona wartość sprawdzania poprawności danych pola wyboru.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isBlank()`

Zwraca wartość true, jeśli zakres jest pusty.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

Powrót

Boolean – true, jeśli zakres jest pusty; w przeciwnym razie false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isChecked()`

Wskazuje, czy wszystkie komórki w zakresie mają pole wyboru „zaznaczone”. Zwraca wartość null, jeśli niektóre komórki są zaznaczone, a pozostałe nie są zaznaczone lub nie są one zaznaczone.

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

Powrót

Boolean – true, jeśli zaznaczono wszystkie komórki w zakresie, false, jeśli wszystkie komórki w zakresie są niezaznaczone, null, jeśli któraś z komórek jest niezaznaczona lub nie weryfikuje danych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isEndColumnBounded()`

Określa, czy koniec zakresu jest powiązany z konkretną kolumną. Na przykład w przypadku zakresów A1:B10 lub B:B, które są powiązane z kolumnami na końcu zakresu, ta metoda zwraca true. W przypadku zakresów 3:7 lub A1:5, które są powiązane tylko z określonymi wierszami na końcu zakresu, ta metoda zwraca false.

Powrót

Boolean – true: jeśli koniec zakresu jest powiązany z konkretną kolumną, false – w przeciwnym razie

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isEndRowBounded()`

Określa, czy koniec zakresu jest powiązany z konkretnym wierszem. Na przykład w przypadku zakresów A1:B10 lub 3:7, które są powiązane z wierszami na końcu zakresu, ta metoda zwraca true. W przypadku zakresów B:B lub A1:C, które są powiązane tylko z określonymi kolumnami na końcu zakresu, ta metoda zwraca false.

Powrót

Boolean – true, jeśli koniec zakresu jest powiązany z konkretnym wierszem; false w przeciwnym razie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isPartOfMerge()`

Zwraca wartość true, jeśli komórki w bieżącym zakresie nakładają się na komórki scalone.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

Powrót

Boolean – true, jeśli zakres nakłada się na scalone komórki, w przeciwnym razie zwraca false.

`isStartColumnBounded()`

Określa, czy początek zakresu jest powiązany z konkretną kolumną. Na przykład w przypadku zakresów A1:B10 lub B:B, które są powiązane z kolumnami na początku zakresu, ta metoda zwraca wartość true. W przypadku zakresu 3:7, który jest powiązany tylko z wierszem na początku zakresu, ta metoda zwraca wartość false.

Powrót

Boolean – true, jeśli początek zakresu jest powiązany z konkretną kolumną; false w przeciwnym razie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isStartRowBounded()`

Określa, czy początek zakresu jest powiązany z konkretnym wierszem. Na przykład w przypadku zakresów A1:B10 i 3:7, które są powiązane z wierszami na początku zakresu, ta metoda zwraca true. W przypadku zakresu B:B, który jest powiązany tylko z konkretną kolumną na początku zakresu, ta metoda zwraca false.

Powrót

Boolean – true, jeśli początek zakresu jest powiązany z konkretnym wierszem; false w przeciwnym razie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`merge()`

Scala komórki z zakresu w jeden blok.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`mergeAcross()`

Scal komórki w zakresie z kolumn.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`mergeVertically()`

Scala komórki w zakresie.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveTo(target)`

Wytnij i wklej z tego zakresu (zarówno format, jak i wartości) do zakresu docelowego.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

Parametry

Nazwa	Typ	Opis
`target`	`Range`	Zakres docelowy, do którego należy skopiować ten zakres. Istotne jest tylko położenie komórki w lewym górnym rogu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`offset(rowOffset, columnOffset)`

Zwraca nowy zakres odsunięty od podanego zakresu o podaną liczbę wierszy i kolumn (, która może być ujemna). Nowy zakres ma taki sam rozmiar jak pierwotny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

Parametry

Nazwa	Typ	Opis
`rowOffset`	`Integer`	Liczba wierszy w dół od lewej górnej komórki zakresu; wartości ujemne reprezentują wiersze w lewym górnym rogu zakresu.
`columnOffset`	`Integer`	Liczba kolumn pochodzących bezpośrednio z komórki w lewym górnym rogu zakresu. Wartości ujemne przedstawiają kolumny po lewej stronie od lewego górnego rogu zakresu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

`offset(rowOffset, columnOffset, numRows)`

Zwraca nowy zakres w odniesieniu do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz od podanego wzrostu w komórkach.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

Parametry

Nazwa	Typ	Opis
`rowOffset`	`Integer`	Liczba wierszy w dół od lewej górnej komórki zakresu; wartości ujemne reprezentują wiersze w lewym górnym rogu zakresu.
`columnOffset`	`Integer`	Liczba kolumn pochodzących bezpośrednio z komórki w lewym górnym rogu zakresu. Wartości ujemne przedstawiają kolumny po lewej stronie od lewego górnego rogu zakresu.
`numRows`	`Integer`	Wysokość w wierszach nowego zakresu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

`offset(rowOffset, columnOffset, numRows, numColumns)`

Zwraca nowy zakres w stosunku do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz podaną wysokość i szerokość w komórkach.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

Parametry

Nazwa	Typ	Opis
`rowOffset`	`Integer`	Liczba wierszy w dół od lewej górnej komórki zakresu; wartości ujemne reprezentują wiersze w lewym górnym rogu zakresu.
`columnOffset`	`Integer`	Liczba kolumn pochodzących bezpośrednio z komórki w lewym górnym rogu zakresu. Wartości ujemne przedstawiają kolumny po lewej stronie od lewego górnego rogu zakresu.
`numRows`	`Integer`	Wysokość w wierszach nowego zakresu.
`numColumns`	`Integer`	Szerokość w kolumnach nowego zakresu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

`protect()`

Tworzy obiekt, który może chronić zakres przed edytowaniem przez użytkowników z odpowiednimi uprawnieniami. Dopóki skrypt nie zmieni listy edytorów zakresu (wywołanie Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) lub ustawienie nowej wartości dla Protection.setDomainEdit(editable)), uprawnienia te będą powielać zawartość samego arkusza kalkulacyjnego, co oznacza, że zakres pozostanie niezabezpieczony. Jeśli zakres jest już chroniony, ta metoda tworzy nowy zakres chroniony, który nakłada się na istniejący. Jeśli komórka jest chroniona przez wiele chronionych zakresów, a którykolwiek z nich uniemożliwia danej osobie edytowanie tej komórki, nie może on edytować tej komórki.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Powrót

Protection – obiekt reprezentujący ustawienia zabezpieczeń;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`randomize()`

Kolejność losowa wierszy w danym zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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. Usuwaje weryfikację danych każdej komórki i dodatkowo usuwa jej 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 range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeDuplicates()`

Usuwa wiersze z tego zakresu zawierające wartości będące duplikatami wartości z dowolnego poprzedniego wiersza. Wiersze z identycznymi wartościami, które różnią się wielkością liter, formatowaniem lub formułami, są uznawane za duplikaty. Ta metoda usuwa także duplikaty wierszy ukryte w widoku (na przykład ze względu na filtr). Treści spoza tego zakresu nie są usuwane.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

Powrót

Range – wynikowy zakres po usunięciu duplikatów. Rozmiar zakresu jest zmniejszany o wiersz dla każdego usuniętego wiersza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeDuplicates(columnsToCompare)`

Usuwa wiersze z tego zakresu, które zawierają wartości z określonych kolumn będące duplikatami wartości z dowolnego poprzedniego wiersza. Wiersze z identycznymi wartościami, które różnią się wielkością liter, formatowaniem lub formułami, są uznawane za duplikaty. Ta metoda usuwa także duplikaty wierszy ukryte w widoku (np. z powodu filtra). Treści spoza tego zakresu nie są usuwane.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

Parametry

Nazwa	Typ	Opis
`columnsToCompare`	`Integer[]`	Kolumny do analizy duplikatów wartości. Jeśli nie podasz żadnych kolumn, wszystkie kolumny zostaną przeanalizowane pod kątem duplikatów.

Powrót

Range – wynikowy zakres po usunięciu duplikatów. Rozmiar zakresu jest zmniejszany o wiersz dla każdego usuniętego wiersza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 wszystkich komórek w zakresie w notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
range.setBackground("red");

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kod koloru w notacji CSS (np. `'#ffffff'` lub `'white'`). Wartość `null` resetuje kolor.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgroundObject(color)`

Ustawia kolor tła wszystkich komórek w zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Kolor tła do ustawienia. Wartość `null` resetuje kolor tła.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgroundObjects(color)`

Ustawia prostokątną siatkę kolorów tła (musi pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

Parametry

Nazwa	Typ	Opis
`color`	`Color[][]`	Dwuwymiarowa tablica kolorów; wartości `null` umożliwiają zresetowanie koloru.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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, podając wartości RGB (liczby całkowite z zakresu od 0 do 255).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Parametry

Nazwa	Typ	Opis
`red`	`Integer`	Czerwona wartość w zapisie RGB.
`green`	`Integer`	Wartość zielona w notacji RGB.
`blue`	`Integer`	Niebieska wartość w zapisie RGB.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgrounds(color)`

Ustawia prostokątną siatkę kolorów tła (musi pasować do wymiarów tego zakresu). Kolory są zapisane w notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

Parametry

Nazwa	Typ	Opis
`color`	`String[][]`	Dwuwymiarowa tablica kolorów w notacji CSS (np. `'#ffffff'` lub `'white'`). Kolor `null` zmienia kolor.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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)`

Określa właściwość obramowania. Prawidłowe wartości to true (wł.), false (wyłączone) i null (bez zmian).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.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 wewnętrzne pionowe, `false` brak – brak zmiany `null`.
`horizontal`	`Boolean`	`true` – obramowania poziome wewnętrzne, `false` – brak, `null` – bez zmian.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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, która określa kolor lub styl. Prawidłowe wartości to true (wł.), false (wyłączone) i null (bez zmian). W przypadku koloru użyj koloru w notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.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 wewnętrzne pionowe, `false` brak – brak zmiany `null`.
`horizontal`	`Boolean`	`true` – obramowania poziome wewnętrzne, `false` – brak, `null` – bez zmian.
`color`	`String`	Kolor w notacji CSS (np. `'#ffffff'` lub `'white'`) `null` (kolor czarny).
`style`	`BorderStyle`	Styl obramowania. Styl domyślny dla `null` (ciągły).

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setDataValidation(rule)`

Ustawia jedną regułę sprawdzania poprawności danych dla wszystkich komórek w zakresie.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
`rule`	`DataValidation`	Reguła weryfikacji danych, którą chcesz ustawić, lub `null`, aby usunąć weryfikację danych.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setDataValidations(rules)`

Ustawia reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie. Ta metoda stosuje dwuwymiarowy zakres weryfikacji danych, indeksowany według wiersza, a następnie kolumny. Wymiary tablicy muszą odpowiadać wymiarom zakresu.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parametry

Nazwa	Typ	Opis
`rules`	`DataValidation[][]`	Dwuwymiarowa tablica reguł weryfikacji danych do ustawienia; wartości `null` usuwają weryfikację danych.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontColor("red");

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor czcionki w notacji CSS (np. `'#ffffff'` lub `'white'`); wartość `null` resetuje kolor.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColorObject(color)`

Ustawia kolor czcionki dla wybranego zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Kolor czcionki do ustawienia. Wartość `null` resetuje kolor.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColorObjects(colors)`

Ustawia prostokątną siatkę kolorów (musi pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

Parametry

Nazwa	Typ	Opis
`colors`	`Color[][]`	Dwuwymiarowa tablica kolorów; wartości `null` umożliwiają zresetowanie koloru czcionki.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColors(colors)`

Ustawia prostokątną siatkę kolorów (musi pasować do wymiarów tego zakresu). Kolory są zapisane w notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

Parametry

Nazwa	Typ	Opis
`colors`	`Object[][]`	Dwuwymiarowa tablica kolorów w notacji CSS (np. `'#ffffff'` lub `'white'`). Kolor `null` zmienia kolor.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontFamilies(fontFamilies)`

Ustawia prostokątną siatkę z rodzinami czcionek (musi pasować do wymiarów w tym zakresie). Przykładami rodzin czcionek są „sport” lub „prostokąt”.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Parametry

Nazwa	Typ	Opis
`fontFamilies`	`Object[][]`	Dwuwymiarowa tablica rodzin czcionek; wartości `null` resetują rodzinę czcionek.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontFamily(fontFamily)`

Określa rodzinę czcionek, np. „render” lub „HGOOG”.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

Parametry

Nazwa	Typ	Opis
`fontFamily`	`String`	Rodzina czcionek do ustawienia. Wartość `null` resetuje rodzinę czcionek.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 dla danego zakresu ('underline', 'line-through' lub 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Parametry

Nazwa	Typ	Opis
`fontLine`	`String`	Styl linii czcionki: `'underline'`, `'line-through'` lub `'none'`. Wartość `null` resetuje styl linii czcionek.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontLines(fontLines)`

Ustawia prostokątną siatkę stylów linii (musi pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Parametry

Nazwa	Typ	Opis
`fontLines`	`Object[][]`	Dwuwymiarowa tablica stylów linii czcionki (`'underline'`, `'line-through'` lub `'none'`); wartości `null` resetują czcionkę.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 (rozmiar punktowy).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontSize(20);

Parametry

Nazwa	Typ	Opis
`size`	`Integer`	Rozmiar czcionki w punktach.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontSizes(sizes)`

Ustawia prostokątną siatkę rozmiarów czcionek (musi pasować do wymiarów w tym zakresie). Rozmiary są podawane w punktach.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Parametry

Nazwa	Typ	Opis
`sizes`	`Object[][]`	Dwuwymiarowa tablica rozmiarów.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 dla danego zakresu ('italic' lub 'normal').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

Parametry

Nazwa	Typ	Opis
`fontStyle`	`String`	Styl czcionki `'italic'` lub `'normal'`. Wartość `null` resetuje styl czcionki.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontStyles(fontStyles)`

Ustawia prostokątną siatkę stylów czcionek (musi pasować do wymiarów w tym zakresie).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parametry

Nazwa	Typ	Opis
`fontStyles`	`Object[][]`	Dwuwymiarowa tablica stylów czcionki (`'italic'` lub `'normal'`). Wartości `null` resetują styl czcionki.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 danego zakresu (normalna/pogrubiona).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Parametry

Nazwa	Typ	Opis
`fontWeight`	`String`	grubość czcionki `'bold'` lub `'normal'`; wartość `null` resetuje grubość czcionki.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontWeights(fontWeights)`

Ustawia prostokątną siatkę grubości czcionek (musi pasować do wymiarów tego zakresu). Przykładem grubości czcionki jest „pogrubienie”.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Parametry

Nazwa	Typ	Opis
`fontWeights`	`Object[][]`	Dwuwymiarowa waga czcionki (`'bold'` lub `'normal'`); wartości `null` resetują grubość czcionki.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 tego zakresu. Podana formuła musi być w notacji A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Ciąg reprezentujący formułę do ustawienia w komórce.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 tego zakresu. Podana formuła musi być w notacji R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Formuła ciągu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormulas(formulas)`

Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu). Podane formuły muszą być zapisane w notacji A1. Ta metoda pobiera dwuwymiarową tablicę formuł indeksowanych według wiersza, a następnie według kolumny. Wymiary tablicy muszą odpowiadać wymiarom zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Parametry

Nazwa	Typ	Opis
`formulas`	`String[][]`	Dwuwymiarowa tablica ciągów formuł.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormulasR1C1(formulas)`

Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu). Podane formuły muszą być zapisane w notacji R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parametry

Nazwa	Typ	Opis
`formulas`	`String[][]`	Dwuwymiarowa tablica formuł w formacie R1C1.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHorizontalAlignment(alignment)`

Ustaw wyrównanie w poziomie (od lewej do prawej) w przypadku wybranego zakresu (w lewo, do środka lub w prawo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie ma wartość `'left'`, `'center'` lub `'normal'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHorizontalAlignments(alignments)`

Ustawia prostokątną siatkę wyrównania w poziomie. Zobacz setHorizontalAlignment(alignment)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Parametry

Nazwa	Typ	Opis
`alignments`	`Object[][]`	Dwuwymiarowa tablica wyrównań: `'left'`, `'center'` lub `'normal'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

setHorizontalAlignment(alignment)

`setNote(note)`

Przypisuje do notatki wartość.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

Parametry

Nazwa	Typ	Opis
`note`	`String`	Wartość notatki, którą możesz ustawić dla zakresu; wartość `null` usuwa notatkę.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNotes(notes)`

Ustawia prostokątną siatkę notatek (musi pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Parametry

Nazwa	Typ	Opis
`notes`	`Object[][]`	Dwuwymiarowa tablica notatek; wartości `null` usuwają notatkę.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

setNote(note)

`setNumberFormat(numberFormat)`

Ustawia liczbę lub format daty dla danego ciągu formatowania. Akceptowane wzorce formatów są opisane w dokumentacji interfejsu Sheets API.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

Parametry

Nazwa	Typ	Opis
`numberFormat`	`String`	Ma format liczbowy.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNumberFormats(numberFormats)`

Ustawia prostokątną siatkę liczb lub formatów daty (musi pasować do wymiarów w tym zakresie). Wartości te to ciągi znaków formatu opisane w dokumentacji interfejsu Sheets API.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

Parametry

Nazwa	Typ	Opis
`numberFormats`	`Object[][]`	Dwuwymiarowa tablica formatów liczb.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRichTextValue(value)`

Ustawia wartość RTF dla komórek w zakresie.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Parametry

Nazwa	Typ	Opis
`value`	`RichTextValue`	Żądana wartość z elementami rozszerzonymi.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRichTextValues(values)`

Ustawia prostokątną siatkę wartości tekstu sformatowanego.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parametry

Nazwa	Typ	Opis
`values`	`RichTextValue[][]`	Żądane wartości tekstu sformatowanego.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 zakres powinien wyświetlać hiperlinki.

Parametry

Nazwa	Typ	Opis
`showHyperlink`	`Boolean`	Określa, czy hiperlink ma być wyświetlany.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 zakresie. Jeśli określony kierunek to null, zostanie on ustalony, a następnie ustawiony.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametry

Nazwa	Typ	Opis
`direction`	`TextDirection`	Oczekiwany kierunek tekstu. Jeśli zasada `null` jest ustawiana, przed ustawieniem ustaw kierunek.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextDirections(directions)`

Ustawia prostokątną siatkę tekstu. Jeśli określony kierunek to null, zostanie on ustalony, a następnie ustawiony.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Parametry

Nazwa	Typ	Opis
`directions`	`TextDirection[][]`	Oczekiwane wskazówki tekstowe. Jeśli określony kierunek to `null`, jest on ustalany przed ustawieniem.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotation(degrees)`

Określa ustawienia rotacji tekstu w komórkach zakresu. Dane wejściowe odpowiadają kątowi między standardową orientacją tekstu a żądaną orientacją. Wpisanie zera oznacza, że tekst jest ustawiony jako standardowy.

W przypadku tekstu tekstowego od lewej do prawej dodatnie kąty są widoczne w kierunku przeciwnym do ruchu wskazówek zegara, a w prawo – w lewo.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Parametry

Nazwa	Typ	Opis
`degrees`	`Integer`	Pożądany kąt między standardowym i standardowym układem orientacji. W przypadku tekstu od lewej do prawej kąty dodatnie są widoczne w lewo.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotation(rotation)`

Określa ustawienia rotacji tekstu w komórkach zakresu.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Parametry

Nazwa	Typ	Opis
`rotation`	`TextRotation`	Określone ustawienia rotacji tekstu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotations(rotations)`

Ustawia prostokątną siatkę rotacji tekstu.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Parametry

Nazwa	Typ	Opis
`rotations`	`TextRotation[][]`	Określone ustawienia rotacji tekstu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextStyle(style)`

Ustawia styl tekstu w komórkach zakresu.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Parametry

Nazwa	Typ	Opis
`style`	`TextStyle`	Wymagany styl tekstu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextStyles(styles)`

Ustawia prostokątną siatkę stylów tekstu.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

Parametry

Nazwa	Typ	Opis
`styles`	`TextStyle[][]`	Style stylu tekstu, których potrzebujesz.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setValue(value)`

Określa wartość zakresu. Wartością może być liczba, ciąg znaków, wartość logiczna lub data. Jeśli zaczyna się od '=', jest interpretowana jako formuła.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

Parametry

Nazwa	Typ	Opis
`value`	`Object`	Wartość dla zakresu.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setValues(values)`

Ustawia prostokątną siatkę wartości (musi pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

Parametry

Nazwa	Typ	Opis
`values`	`Object[][]`	Dwuwymiarowa tablica wartości.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 (od góry do dołu) dla wybranego zakresu (góra/środek/dół).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie ma wartość `'top'`, `'middle'` lub `'bottom'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setVerticalAlignments(alignments)`

Ustawia prostokątną siatkę wyrównań w pionie (musi pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Parametry

Nazwa	Typ	Opis
`alignments`	`Object[][]`	Dwuwymiarowa tablica wyrównań: `'top'`, `'middle'` lub `'bottom'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Określa, czy tekst dla komórek w zakresie ma być ułożony w stos. Jeśli tekst jest ułożony pionowo, poziom obrotu tekstu jest ignorowany.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Parametry

Nazwa	Typ	Opis
`isVertical`	`Boolean`	Określa, czy tekst ma być nałożony.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrap(isWrapEnabled)`

Ustaw zawijanie komórki do podanego zakresu.

Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, aby wyświetlać pełną treść. Komórki z wyłączonym zawijaniem wyświetlają się w komórce w jak największym stopniu bez zmiany rozmiaru czy wyświetlania w wielu wierszach.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

Parametry

Nazwa	Typ	Opis
`isWrapEnabled`	`Boolean`	Określa, czy zawijać tekst, czy nie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrapStrategies(strategies)`

Ustawia prostokątną siatkę strategii zawijania.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Parametry

Nazwa	Typ	Opis
`strategies`	`WrapStrategy[][]`	Żądane strategie tworzenia paczek.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą 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 w komórkach zakresu.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametry

Nazwa	Typ	Opis
`strategy`	`WrapStrategy`	Wybrana strategia dodawania tagów.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWraps(isWrapEnabled)`

Ustawia prostokątną siatkę zawijania słów (musi pasować do wymiarów tego zakresu). Komórki z włączoną funkcją domyślnego opakowania są zmieniane, tak aby ich pełna treść była wyświetlana w całości. Komórki z wyłączonym zawijaniem wyświetlają możliwie najwięcej zmian bez zmiany rozmiaru lub wyświetlania w wielu wierszach.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Parametry

Nazwa	Typ	Opis
`isWrapEnabled`	`Object[][]`	Dwuwymiarowa tablica zmiennych, która określa, czy zawijać tekst w komórce.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Zmienia głębokość grupowania zakresu o określoną kwotę.

Efektem jest tworzenie, modyfikowanie i usuwanie grup krzyżujących się w tym zakresie. Grupy delta są tworzone lub modyfikowane, a w przypadku delta są niszczone lub modyfikowane.

Nie powoduje to spadku głębokości grupy poniżej 0 ani powyżej 8.

Jeśli column group control position to BEFORE, gdy próbujesz przesunąć głębokość pierwszego wiersza, pojawi się błąd.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parametry

Nazwa	Typ	Opis
`delta`	`Integer`	Kwota, o jaką ma zostać zmieniona głębokość grupy kolumn w tym zakresie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Narzuty

Error – gdy próbujesz zmienić głębokość pierwszej kolumny, gdy GroupControlTogglePosition.BEFORE ma pozycję kontrolną

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`shiftRowGroupDepth(delta)`

Zmienia głębokość grupowania zakresu o określoną kwotę.

Efektem jest tworzenie, modyfikowanie i usuwanie grup krzyżujących się w tym zakresie. Grupy delta są tworzone lub modyfikowane, a w przypadku delta są niszczone lub modyfikowane.

Nie powoduje to spadku głębokości grupy poniżej 0 ani powyżej 8.

Jeśli row group control position to BEFORE, podczas próby zmiany głębokości pierwszego wiersza zwracany jest błąd.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parametry

Nazwa	Typ	Opis
`delta`	`Integer`	Wartość, o jaką ma zostać zmieniona głębokość grupy wierszy w tym zakresie.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Narzuty

Error – gdy użytkownik próbuje przesunąć głębokość pierwszego wiersza, gdy pozycja kontrolna to GroupControlTogglePosition.BEFORE

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`sort(sortSpecObj)`

Sortuje komórki z danego zakresu według kolumny i kolejności.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

Parametry

Nazwa	Typ	Opis
`sortSpecObj`	`Object`	Kolumny do sortowania.

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`splitTextToColumns()`

Dzieli kolumnę tekstu na wiele kolumn na podstawie automatycznego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`splitTextToColumns(delimiter)`

Dzieli kolumnę tekstu na kolumny, używając określonego ciągu jako niestandardowego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametry

Nazwa	Typ	Opis
`delimiter`	`String`	Niestandardowy separator, który należy podzielić.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`splitTextToColumns(delimiter)`

Dzieli kolumnę tekstu na kilka kolumn na podstawie określonego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametry

Nazwa	Typ	Opis
`delimiter`	`TextToColumnsDelimiter`	Gotowe ustawienia separatora.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`trimWhitespace()`

Służy do wycinania odstępów (np. spacji, kart lub nowych wierszy) w każdej komórce zakresu. Usuwa całą spację z początku i końca tekstu w każdej komórce oraz zmniejsza znaczenie pozostałych znaków odstępów w pojedynczym miejscu.

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)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`uncheck()`

Zmienia stan pól wyboru w zakresie na „niezaznaczone”. Ignoruje wartości z komórek w zakresie, które obecnie nie zawierają żadnej zaznaczonej lub niezaznaczonej wartości.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Powrót

Range – ten zakres do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Metody wycofane

`getFontColor()`

Wycofane. Zastąpione przez: getFontColorObject()

Zwraca kolor czcionki komórki w lewym górnym rogu zakresu w notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColor());

Powrót

String – kolor czcionki w notacji CSS (np. '#ffffff' lub 'white').

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontColors()`

Wycofane. Zastąpione przez: getFontColorObjects()

Zwraca kolory czcionki komórek w zakresie w notacji CSS (np. '#ffffff' lub 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColors();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Powrót

String[][] – dwuwymiarowa tablica kolorów czcionki powiązana z komórkami w zakresie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets