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

Class Range

Dostęp do zakresów w arkuszach kalkulacyjnych i ich modyfikowanie. Zakresem może być jedna komórka w arkuszu lub grupa sąsiednich komórek w arkuszu.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`Range`	Ustawia określony zakres jako `active range`, a lewa górna komórka w zakresie to `current cell`.
`activateAsCurrentCell()`	`Range`	Ustawia określoną komórkę jako `current cell`.
`addDeveloperMetadata(key)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem.
`addDeveloperMetadata(key, visibility)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem i widocznością.
`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`	Powoduje zastosowanie do zakresu domyślnego motywu pasma kolumn.
`applyColumnBanding(bandingTheme)`	`Banding`	Powoduje zastosowanie do zakresu określonego motywu pasm kolumn.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje określony motyw pasma kolumn do zakresu z określonymi ustawieniami nagłówka i stopki.
`applyRowBanding()`	`Banding`	Powoduje zastosowanie do zakresu domyślnego motywu pasma wierszy.
`applyRowBanding(bandingTheme)`	`Banding`	Powoduje zastosowanie do zakresu określonego motywu pasma wierszy.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje określony motyw pasma wierszy 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, który zostanie wypełniony nowymi danymi na podstawie sąsiednich komórek, i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych zawartych w tym zakresie.
`breakApart()`	`Range`	Ponownie podziel wszystkie komórki z wieloma kolumnami 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, formatu, reguł sprawdzania poprawności danych lub komentarzy zgodnie z określonymi opcjami zaawansowanymi.
`clearContent()`	`Range`	Usuwa treść zakresu, pozostawiając formatowanie bez zmian.
`clearDataValidations()`	`Range`	Czyści reguły sprawdzania poprawności danych w tym zakresie.
`clearFormat()`	`Range`	Czyści formatowanie w tym zakresie.
`clearNote()`	`Range`	Czyści notatkę w danej komórce lub komórce.
`collapseGroups()`	`Range`	Zwija wszystkie grupy, które w całości należą do zakresu.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do danej lokalizacji.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do danej lokalizacji.
`copyTo(destination)`	`void`	Kopiowanie danych z zakresu komórek do innego zakresu komórek.
`copyTo(destination, copyPasteType, transposed)`	`void`	Kopiowanie danych z zakresu komórek do innego zakresu komórek.
`copyTo(destination, options)`	`void`	Kopiowanie danych z zakresu komórek 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 ze źródła danych pustą tabelę przestawną źródła danych zakotwiczoną w pierwszej komórce w tym zakresie.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Tworzy ze źródła danych pustą tabelę źródeł danych zakotwiczoną w pierwszej komórce w tym zakresie.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca obiekt DeveloperMetadataFinderApi do znajdowania metadanych dewelopera w zakresie tego zakresu.
`createFilter()`	`Filter`	Tworzy filtr i stosuje go do określonego zakresu w arkuszu.
`createPivotTable(sourceData)`	`PivotTable`	Tworzy pustą tabelę przestawną z określonego elementu `sourceData` zakotwiczonego w pierwszej komórce w tym zakresie.
`createTextFinder(findText)`	`TextFinder`	Tworzy wyszukiwarkę tekstu dla zakresu, która może znajdować i zastępować tekst w tym zakresie.
`deleteCells(shiftDimension)`	`void`	Usuwa ten zakres komórek.
`expandGroups()`	`Range`	Rozwija zwinięte grupy, których zakres lub przełącznik sterowania przecinają ten zakres.
`getA1Notation()`	`String`	Zwraca opis ciągu znaków zakresu w notacji 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 (np. `'#ffffff'`).
`getBandings()`	`Banding[]`	Zwraca wszystkie pasma zastosowane do komórek w danym zakresie.
`getCell(row, column)`	`Range`	Zwraca podaną komórkę w zakresie.
`getColumn()`	`Integer`	Zwraca pozycję kolumny początkowej dla tego zakresu.
`getDataRegion()`	`Range`	Zwraca kopię zakresu rozwiniętego w 4 kartach `Direction`, aby pokryć wszystkie sąsiednie komórki zawierające dane.
`getDataRegion(dimension)`	`Range`	Zwraca kopię zakresu rozwiniętego `Direction.UP` i `Direction.DOWN`, jeśli podany wymiar to `Dimension.ROWS`, lub `Direction.NEXT` i `Direction.PREVIOUS`, jeśli wymiar to `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Zwraca `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` dla komórek w zakresie.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródła danych przecinające zakres.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych przecinające 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 tabela DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Zwraca dane z tego zakresu w postaci tabeli DataTable.
`getDataValidation()`	`DataValidation`	Zwraca regułę sprawdzania poprawności danych dla lewej górnej komórki zakresu.
`getDataValidations()`	`DataValidation[][]`	Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Pobiera metadane dewelopera powiązane z tym zakresem.
`getDisplayValue()`	`String`	Zwraca wartość wyświetlaną w lewej górnej komórce zakresu.
`getDisplayValues()`	`String[][]`	Zwraca prostokątną siatkę wartości z 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 czcionek w komórkach zakresu.
`getFontFamilies()`	`String[][]`	Zwraca rodziny czcionek dla komórek w zakresie.
`getFontFamily()`	`String`	Zwraca rodzinę czcionek w komórce w lewym górnym rogu zakresu.
`getFontLine()`	`String`	Pobiera styl linii z 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 punktach rozmiaru komórki w lewym górnym rogu zakresu.
`getFontSizes()`	`Integer[][]`	Zwraca rozmiar czcionki w komórkach w zakresie.
`getFontStyle()`	`String`	Zwraca styl czcionki (`'italic'` lub `'normal'`) komórki w lewym górnym rogu zakresu.
`getFontStyles()`	`String[][]`	Zwraca style czcionek w komórkach zakresu.
`getFontWeight()`	`String`	Zwraca grubość czcionki (zwykłą/pogrubioną) komórki w lewym górnym rogu zakresu.
`getFontWeights()`	`String[][]`	Zwraca grubość czcionek w komórkach zakresu.
`getFormula()`	`String`	Zwraca formułę (w notacji A1) dla 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łę (notacja R1C1) dla danej komórki lub `null`, jeśli nie ma jej wcale.
`getFormulas()`	`String[][]`	Zwraca formuły (notacja A1) dla komórek w zakresie.
`getFormulasR1C1()`	`String[][]`	Zwraca formuły (notacja R1C1) dla komórek w zakresie.
`getGridId()`	`Integer`	Zwraca identyfikator siatki arkusza nadrzędnego zakresu.
`getHeight()`	`Integer`	Zwraca wysokość zakresu.
`getHorizontalAlignment()`	`String`	Zwraca wyrównanie tekstu w poziomie (do lewej/do środka/do prawej) komórki w lewym górnym rogu zakresu.
`getHorizontalAlignments()`	`String[][]`	Zwraca wyrównanie poziome komórek w zakresie.
`getLastColumn()`	`Integer`	Zwraca pozycję końcową kolumny.
`getLastRow()`	`Integer`	Zwraca końcową pozycję wiersza.
`getMergedRanges()`	`Range[]`	Zwraca tablicę obiektów `Range` reprezentujących scalone komórki, które znajdują się w całości w bieżącym zakresie lub zawierają co najmniej jedną komórkę w bieżącym zakresie.
`getNextDataCell(direction)`	`Range`	Począwszy od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w podanym kierunku, który jest krawędzią sąsiadującego zakresu komórek z danymi, lub komórki znajdującej się na krawędzi arkusza kalkulacyjnego w tym kierunku.
`getNote()`	`String`	Zwraca notatkę powiązaną z podanym zakresem.
`getNotes()`	`String[][]`	Zwraca notatki powiązane z komórkami w zakresie.
`getNumColumns()`	`Integer`	Zwraca liczbę kolumn w tym zakresie.
`getNumRows()`	`Integer`	Zwraca liczbę wierszy w tym zakresie.
`getNumberFormat()`	`String`	Pobierz formatowanie liczby lub daty z lewej górnej komórki danego zakresu.
`getNumberFormats()`	`String[][]`	Zwraca liczbę lub format daty dla komórek w zakresie.
`getRichTextValue()`	`RichTextValue`	Zwraca wartość tekstu sformatowanego dla lewej górnej komórki zakresu lub `null`, jeśli komórka nie jest tekstem.
`getRichTextValues()`	`RichTextValue[][]`	Zwraca wartości z tekstu sformatowanego w komórkach 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 dla lewej górnej komórki zakresu.
`getTextDirections()`	`TextDirection[][]`	Zwraca kierunek tekstu dla komórek w zakresie.
`getTextRotation()`	`TextRotation`	Zwraca ustawienia rotacji tekstu dla lewej górnej komórki 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 w komórkach w zakresie.
`getValue()`	`Object`	Zwraca wartość lewej górnej komórki zakresu.
`getValues()`	`Object[][]`	Zwraca prostokątną siatkę wartości z tego zakresu.
`getVerticalAlignment()`	`String`	Zwraca wyrównanie w pionie (do góry/do środka/do dołu) komórki w lewym górnym rogu zakresu.
`getVerticalAlignments()`	`String[][]`	Zwraca wyrównanie pionowe 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 w komórkach w zakresie.
`getWrapStrategy()`	`WrapStrategy`	Zwraca strategię zawijania tekstu dla lewej górnej komórki zakresu.
`getWraps()`	`Boolean[][]`	Zwraca, czy tekst w komórkach jest zawijany.
`insertCells(shiftDimension)`	`Range`	Wstawia do tego zakresu puste komórki.
`insertCheckboxes()`	`Range`	Wstawia pola wyboru w każdej komórce w zakresie z zaznaczoną wartością `true` i odznaczoną `false`.
`insertCheckboxes(checkedValue)`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem znaków, jeśli nie jest zaznaczone.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie skonfigurowanych przy użyciu niestandardowych wartości stanów zaznaczonego i odznaczonego.
`isBlank()`	`Boolean`	Zwraca wartość `true`, jeśli zakres jest całkowicie pusty.
`isChecked()`	`Boolean`	Zwraca, czy wszystkie komórki w zakresie mają stan pola 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 scalone komórki.
`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 z zakresu we wszystkich kolumnach zakresu.
`mergeVertically()`	`Range`	Scala ze sobą komórki w zakresie.
`moveTo(target)`	`void`	Wytnij i wklej (format i wartości) z tego zakresu do zakresu docelowego.
`offset(rowOffset, columnOffset)`	`Range`	Zwraca nowy zakres odsunięty od tego zakresu o podaną liczbę wierszy i kolumn (która może być ujemna).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Zwraca nowy zakres odnoszący się do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz z podaną wysokością w komórkach.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Zwraca nowy zakres odnoszący się do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz przy podanej wysokości i szerokości w komórkach.
`protect()`	`Protection`	Tworzy obiekt, który może chronić zakres przed edytowaniem – z wyjątkiem użytkowników, którzy mają odpowiednie uprawnienia.
`randomize()`	`Range`	Powoduje losową kolejność wierszy w danym zakresie.
`removeCheckboxes()`	`Range`	Usuwa wszystkie pola wyboru z zakresu.
`removeDuplicates()`	`Range`	Usuwa wiersze z tego zakresu, które zawierają wartości będące duplikatami wartości we wszystkich poprzednich wierszach.
`removeDuplicates(columnsToCompare)`	`Range`	Usuwa wiersze z tego zakresu, które zawierają wartości w określonych kolumnach, które są duplikatami wartości z poprzedniego wiersza.
`setBackground(color)`	`Range`	Określa 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ę z kolorami tła (musi pasować do wymiarów tego zakresu).
`setBackgroundRGB(red, green, blue)`	`Range`	Ustawia kolor tła za pomocą wartości RGB (liczby całkowite od 0 do 255 włącznie).
`setBackgrounds(color)`	`Range`	Ustawia prostokątną siatkę z kolorami tła (musi pasować do wymiarów tego zakresu).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Ustawia właściwość obramowania.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Określa właściwości obramowania z kolorem lub stylem.
`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`	Określa kolor czcionki w notacji CSS (np. `'#ffffff'` lub `'white'`).
`setFontColorObject(color)`	`Range`	Ustawia kolor czcionki w danym zakresie.
`setFontColorObjects(colors)`	`Range`	Ustawia prostokątną siatkę z kolorami czcionek (muszą pasować do wymiarów tego zakresu).
`setFontColors(colors)`	`Range`	Ustawia prostokątną siatkę z kolorami czcionek (muszą pasować do wymiarów tego zakresu).
`setFontFamilies(fontFamilies)`	`Range`	Ustawia prostokątną siatkę rodzin czcionek (muszą pasować do wymiarów tego zakresu).
`setFontFamily(fontFamily)`	`Range`	Ustawia rodzinę czcionek, np. „admob” lub „Hkowa”.
`setFontLine(fontLine)`	`Range`	Ustawia styl czcionki w danym zakresie (`'underline'`, `'line-through'` lub `'none'`).
`setFontLines(fontLines)`	`Range`	Ustawia prostokątną siatkę stylów linii (muszą pasować do wymiarów tego zakresu).
`setFontSize(size)`	`Range`	Ustawia rozmiar czcionki w punktach.
`setFontSizes(sizes)`	`Range`	Ustawia prostokątną siatkę rozmiarów czcionek (muszą pasować do wymiarów tego zakresu).
`setFontStyle(fontStyle)`	`Range`	Ustaw styl czcionki dla danego zakresu (`'italic'` lub `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Ustawia prostokątną siatkę stylów czcionek (muszą pasować do wymiarów tego zakresu).
`setFontWeight(fontWeight)`	`Range`	Ustaw grubość czcionki dla danego zakresu (normalny/pogrubiony).
`setFontWeights(fontWeights)`	`Range`	Ustawia prostokątną siatkę grubości czcionek (muszą pasować do wymiarów tego zakresu).
`setFormula(formula)`	`Range`	Aktualizuje formułę w tym zakresie.
`setFormulaR1C1(formula)`	`Range`	Aktualizuje formułę w tym zakresie.
`setFormulas(formulas)`	`Range`	Ustawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu).
`setFormulasR1C1(formulas)`	`Range`	Ustawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu).
`setHorizontalAlignment(alignment)`	`Range`	Ustaw wyrównanie w poziomie (od lewej do prawej) dla danego zakresu (do lewej/do środka/do prawej).
`setHorizontalAlignments(alignments)`	`Range`	Ustawia prostokątną siatkę z wyrównaniami w poziomie.
`setNote(note)`	`Range`	Ustawia w notatce podaną wartość.
`setNotes(notes)`	`Range`	Ustawia prostokątną siatkę notatek (muszą pasować do wymiarów tego zakresu).
`setNumberFormat(numberFormat)`	`Range`	Ustawia format liczby lub daty dla danego ciągu formatowania.
`setNumberFormats(numberFormats)`	`Range`	Ustawia prostokątną siatkę z formatami liczb lub dat (muszą pasować do wymiarów tego zakresu).
`setRichTextValue(value)`	`Range`	Ustawia wartość tekstu sformatowanego dla komórek w zakresie.
`setRichTextValues(values)`	`Range`	Ustawia prostokątną siatkę wartości z tekstu sformatowanego.
`setShowHyperlink(showHyperlink)`	`Range`	Określa, czy zakres ma wyświetlać hiperlinki.
`setTextDirection(direction)`	`Range`	Ustawia kierunek tekstu w komórkach zakresu.
`setTextDirections(directions)`	`Range`	Ustawia prostokątną siatkę ze wskazówkami dotyczącymi tekstu.
`setTextRotation(degrees)`	`Range`	Określa ustawienia rotacji tekstu dla komórek w zakresie.
`setTextRotation(rotation)`	`Range`	Określa ustawienia rotacji tekstu dla komórek w zakresie.
`setTextRotations(rotations)`	`Range`	Ustawia prostokątną siatkę z rotacjami tekstu.
`setTextStyle(style)`	`Range`	Ustawia styl tekstu w komórkach w zakresie.
`setTextStyles(styles)`	`Range`	Ustawia prostokątną siatkę stylów tekstu.
`setValue(value)`	`Range`	Ustawia wartość zakresu.
`setValues(values)`	`Range`	Ustawia prostokątną siatkę wartości (muszą pasować do wymiarów tego zakresu).
`setVerticalAlignment(alignment)`	`Range`	Ustaw wyrównanie w pionie (od góry do dołu) dla danego zakresu (góra, środek, dół).
`setVerticalAlignments(alignments)`	`Range`	Ustawia prostokątną siatkę z wyrównaniami pionowymi (muszą pasować do wymiarów tego zakresu).
`setVerticalText(isVertical)`	`Range`	Określa, czy tekst w komórkach w zakresie ma być ułożony w stos.
`setWrap(isWrapEnabled)`	`Range`	Ustawia zawijanie komórek w danym zakresie.
`setWrapStrategies(strategies)`	`Range`	Ustawia prostokątną siatkę strategii zawijania.
`setWrapStrategy(strategy)`	`Range`	Ustawia strategię zawijania tekstu w komórkach w zakresie.
`setWraps(isWrapEnabled)`	`Range`	Ustawia prostokątną siatkę z zasadami zawijania słów (muszą pasować do wymiarów tego zakresu).
`shiftColumnGroupDepth(delta)`	`Range`	Zmienia głębokość grupowania kolumn o określoną kwotę.
`shiftRowGroupDepth(delta)`	`Range`	Zmienia głębokość grupowania wierszy o określoną kwotę.
`sort(sortSpecObj)`	`Range`	Sortuje komórki w danym zakresie według określonej kolumny i kolejności.
`splitTextToColumns()`	`void`	Dzieli kolumnę tekstu na kilka kolumn na podstawie automatycznie wykrytego separatora.
`splitTextToColumns(delimiter)`	`void`	Dzieli kolumnę z tekstem na kilka kolumn przy użyciu podanego ciągu jako niestandardowego separatora.
`splitTextToColumns(delimiter)`	`void`	Dzieli kolumnę z tekstem na kilka kolumn na podstawie określonego separatora.
`trimWhitespace()`	`Range`	Usuwa odstępy (np. spacje, znaki tabulacji lub nowe wiersze) z każdej komórki w tym zakresie.
`uncheck()`	`Range`	Zmienia stan pól wyboru w zakresie na „odznaczone”.

Wycofane metody

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, a lewa górna komórka w zakresie to 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();

Powroty

Range – ten zakres na potrzeby łańcuchów.

`activateAsCurrentCell()`

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

Jeśli określona komórka znajduje się w istniejącym zakresie, ten zakres stanie się aktywnym zakresem z komórką bieżącą.

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

Uwaga: podany Range musi składać się z jednej komórki w przeciwnym razie spowoduje zgłoszenie wyjątku.

// 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());

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`addDeveloperMetadata(key)`

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 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 nowych metadanych dewelopera.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`addDeveloperMetadata(key, visibility)`

Dodaje do zakresu metadane dewelopera z określonym kluczem 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 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 nowych metadanych dewelopera.
`visibility`	`DeveloperMetadataVisibility`	Widoczność nowych metadanych dewelopera.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`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 of Sheet1.
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 nowych metadanych dewelopera.
`value`	`String`	Wartość nowych metadanych dewelopera.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`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 nowych metadanych dewelopera.
`value`	`String`	Wartość nowych metadanych dewelopera.
`visibility`	`DeveloperMetadataVisibility`	Widoczność nowych metadanych dewelopera.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`applyColumnBanding()`

Powoduje zastosowanie do zakresu domyślnego motywu pasma kolumn. Domyślnie pasy mają kolor 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 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());

Powroty

Banding – nowe pasy.

Upoważnienie

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

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

`applyColumnBanding(bandingTheme)`

Powoduje zastosowanie do zakresu określonego motywu pasm kolumn. Domyślnie pasy mają kolor 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 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 kolorystyczny do zastosowania do kolumn w zakresie.

Powroty

Banding – nowe pasy.

Upoważnienie

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

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Stosuje określony motyw pasma kolumn 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 kolorystyczny do zastosowania do kolumn w zakresie.
`showHeader`	`Boolean`	Jeśli ustawiona jest wartość `true`, kolor nagłówka motywu pasm jest stosowany do pierwszej kolumny.
`showFooter`	`Boolean`	Jeśli ustawiona jest wartość `true`, kolor stopki motywu pasm jest stosowany do ostatniej kolumny.

Powroty

Banding – nowe pasy.

Upoważnienie

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

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

`applyRowBanding()`

Powoduje zastosowanie do zakresu domyślnego motywu pasma wierszy. Domyślnie pasy mają kolor nagłówka i stopki.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, 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 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Powroty

Banding – pasy.

Upoważnienie

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

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

`applyRowBanding(bandingTheme)`

Powoduje zastosowanie do zakresu określonego motywu pasma wierszy. Domyślnie pasy mają kolor nagłówka i stopki.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, 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 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Parametry

Nazwa	Typ	Opis
`bandingTheme`	`BandingTheme`	Motyw kolorystyczny do zastosowania do wierszy w zakresie.

Powroty

Banding – nowe pasy.

Upoważnienie

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

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, 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 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

Parametry

Nazwa	Typ	Opis
`bandingTheme`	`BandingTheme`	Motyw kolorystyczny do zastosowania do wierszy w zakresie.
`showHeader`	`Boolean`	Jeśli ustawiona jest wartość `true`, kolor nagłówka motywu pasm jest stosowany do pierwszego wiersza.
`showFooter`	`Boolean`	Jeśli ustawiona jest wartość `true`, kolor stopki motywu pasma jest stosowany w ostatnim wierszu.

Powroty

Banding – nowe pasy.

Upoważnienie

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

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

`autoFill(destination, series)`

Wypełnia pole destinationRange danymi na podstawie danych z tego zakresu. Nowe wartości są też określane przez podany typ series. Zakres docelowy musi zawierać ten zakres i rozszerzać go tylko w jednym kierunku. Na przykład ten ciąg znaków w polu A1:A20 wypełnia szereg rosnących liczb na podstawie bieżących wartości w tabeli 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, który ma zostać automatycznie uzupełniony 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óra powinna być używana do obliczania nowych wartości. Wpływ tej serii różni się w zależności od typu i ilości danych źródłowych.

Upoważnienie

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

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

`autoFillToNeighbor(series)`

Oblicza zakres, który zostanie wypełniony nowymi danymi na podstawie sąsiednich komórek, i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych zawartych w tym zakresie. Te nowe wartości są również określane przez określony typ series.

Obliczony zakres docelowy uwzględnia dane otaczające, aby określić, gdzie należy wstawić nowe wartości. Jeśli dane znajdują się bezpośrednio po lewej lub prawej stronie kolumny, która jest uzupełniana automatycznie, nowe wartości rozciągają się tylko do tych sąsiednich danych.

Jeśli np. pole A1:A20 jest wypełniane ciągiem rosnących liczb, a metoda ta jest wywoływana w zakresie B1:B4, który zawiera serię dat, nowe wartości są wstawiane tylko w zakresie B5:B20. W ten sposób nowe wartości „przyklejają się” do komórek zawierających wartości z kolumny 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óra powinna być używana do obliczania nowych wartości. Wpływ tej serii różni się w zależności od typu i ilości danych źródłowych.

Upoważnienie

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

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

`breakApart()`

Ponownie podziel wszystkie komórki z wieloma kolumnami w zakresie na poszczególne komórki.

Wywołanie tej funkcji dla zakresu jest równoważne z wybraniem zakresu i kliknięciem Formatuj > Scal komórki > Rozdziel.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, 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 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`canEdit()`

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, 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 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

Powroty

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 z co najmniej jednym z tych zakresów:

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

`check()`

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`clear()`

Usuwa zakres treści i formatów.

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`clear(options)`

Usuwa zakres treści, formatu, reguł sprawdzania poprawności danych lub komentarzy zgodnie z określonymi opcjami zaawansowanymi. Domyślnie wszystkie dane są czyszczone.

// The code below clears range C2:G7 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, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`commentsOnly`	`Boolean`	Czy usuwać tylko komentarze.
`contentsOnly`	`Boolean`	Określa, czy usunąć samą zawartość.
`formatOnly`	`Boolean`	Określa, czy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu usuwa też reguły sprawdzania poprawności danych.
`validationsOnly`	`Boolean`	Określa, czy wyczyścić tylko reguły sprawdzania poprawności danych.
`skipFilteredRows`	`Boolean`	Określa, czy nie wyczyścić odfiltrowanych wierszy.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`clearContent()`

Usuwa treść zakresu, pozostawiając formatowanie bez zmian.

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`clearDataValidations()`

Czyści reguły sprawdzania poprawności danych w tym zakresie.

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`clearFormat()`

Czyści formatowanie w tym zakresie.

Spowoduje to usunięcie formatowania tekstu w komórce lub komórkach w zakresie, ale nie spowoduje zresetowania żadnych reguł formatowania liczb.

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`clearNote()`

Czyści notatkę w danej komórce lub komórce.

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`collapseGroups()`

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

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

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

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

Szczegółowy opis parametru networkId znajdziesz tutaj: 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 jego pozycji.
`column`	`Integer`	Pierwsza kolumna zakresu docelowego.
`columnEnd`	`Integer`	Kolumna końcowa 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 z co najmniej jednym 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`	Kolumna końcowa 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 z co najmniej jednym z tych zakresów:

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

`copyTo(destination)`

Kopiowanie danych z zakresu komórek 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 kopiowania. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.

Upoważnienie

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

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

`copyTo(destination, copyPasteType, transposed)`

Kopiowanie danych z zakresu komórek 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 kopiowania. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.
`copyPasteType`	`CopyPasteType`	Typ, który określa sposób wklejania zawartości zakresu do miejsca docelowego.
`transposed`	`Boolean`	Określa, czy zakres ma zostać wklejony w orientacji przetransponowanej.

Upoważnienie

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

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

`copyTo(destination, options)`

Kopiowanie danych z zakresu komórek do innego zakresu komórek. Domyślnie kopiowane są zarówno wartości, jak i formatowanie, ale można to 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 kopiowania. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.
`options`	`Object`	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`formatOnly`	`Boolean`	wskazuje, że należy skopiować tylko format
`contentsOnly`	`Boolean`	wskazuje, że należy skopiować tylko treść

Upoważnienie

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

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

`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 powtarzane lub odpowiednio obcinane.

Szczegółowy opis parametru networkId znajdziesz tutaj: 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 jego pozycji.
`column`	`Integer`	Pierwsza kolumna zakresu docelowego.
`columnEnd`	`Integer`	Kolumna końcowa 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 z co najmniej jednym 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 powtarzane lub odpowiednio obcinane.

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`	Kolumna końcowa 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 z co najmniej jednym z tych zakresów:

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

`createDataSourcePivotTable(dataSource)`

Tworzy ze źródła danych pustą tabelę przestawną źródła danych zakotwiczoną w pierwszej komórce w tym zakresie.

Z tego przykładu dowiesz się, 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, na podstawie którego zostanie utworzona tabela przestawna.

Powroty

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

Upoważnienie

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

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

`createDataSourceTable(dataSource)`

Tworzy ze źródła danych pustą tabelę źródeł danych zakotwiczoną w pierwszej komórce w tym zakresie.

Z tego przykładu dowiesz się, 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, na podstawie którego zostanie utworzona tabela przestawna.

Powroty

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

Upoważnienie

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

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

`createDeveloperMetadataFinder()`

Zwraca obiekt DeveloperMetadataFinderApi do znajdowania metadanych dewelopera w zakresie tego zakresu. Metadane mieszczą się w zakresie zakresu tylko wtedy, gdy w całości są w nim zawarte. Na przykład metadane powiązane z wierszem „3:3” nie są w zakresie „A1:D5”, ale mieszczą się 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());

Powroty

DeveloperMetadataFinder – wyszukiwarka metadanych dewelopera umożliwiająca wyszukiwanie metadanych z tego zakresu.

`createFilter()`

Tworzy filtr i stosuje go do określonego zakresu w arkuszu. Nie można utworzyć więcej niż 1 filtra w arkuszu. Aby uzyskać dostęp do filtra i go zmodyfikować po jego utworzeniu, użyj 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 arkuszy Grid (domyślnego typu). Arkusze siatki to takie, które nie są połączone z bazą danych. Aby utworzyć inne typy filtrów, zapoznaj się z tymi informacjami:

Tworzenie filtra tabeli przestawnej za pomocą funkcji PivotTable.addFilter(sourceDataColumn, filterCriteria)
Tworzenie filtra dla arkusza połączonego z bazą danych za pomocą funkcji DataSourceSheet.addFilter(columnName, filterCriteria)
Tworzenie filtra dla tabeli przestawnej połączonej z bazą danych za pomocą polecenia DataSourcePivotTable.addFilter(columnName, filterCriteria)

Powroty

Filter – nowy filtr.

Upoważnienie

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

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

`createPivotTable(sourceData)`

Tworzy pustą tabelę przestawną z określonego elementu sourceData zakotwiczonego w 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 zostanie utworzona tabela przestawna.

Powroty

PivotTable – nowo utworzony PivotTable.

Upoważnienie

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

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

`createTextFinder(findText)`

Tworzy wyszukiwarkę tekstu dla zakresu, która może znajdować i zastępować 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 = textFinder.replaceWith('cat');

Parametry

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

Powroty

TextFinder – TextFinder dla danego zakresu

`deleteCells(shiftDimension)`

Usuwa ten zakres komórek. Dotychczasowe dane w arkuszu wzdłuż podanego wymiaru zostaną przesuwane w kierunku 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, wzdłuż którego mają być przesuwane istniejące dane.

Upoważnienie

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

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

`expandGroups()`

Rozwija zwinięte grupy, których zakres lub przełącznik sterowania przecinają ten zakres. Lokalizacja przełącznika sterowania 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 znajduje się więcej niż 1 grupa, najkrótsza grupa jest rozwinięta.

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

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`getA1Notation()`

Zwraca opis ciągu znaków zakresu w notacji 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());

Powroty

String – opis ciągu znaków zakresu w notacji A1.

Upoważnienie

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

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

`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());

Powroty

String – kod koloru tła.

Upoważnienie

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

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

`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());

Powroty

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

Upoważnienie

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

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

`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());
  }
}

Powroty

Color[][] – dwuwymiarowa tablica kolorów tła.

Upoważnienie

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

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

`getBackgrounds()`

Zwraca kolory tła komórek w zakresie (np. '#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]);
  }
}

Powroty

String[][] – dwuwymiarowa tablica kodów kolorów tła.

Upoważnienie

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

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

`getBandings()`

Zwraca wszystkie pasma zastosowane do komórek w danym 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());
}

Powroty

Banding[] – wszystkie pasma zastosowane do komórek w danym zakresie.

Upoważnienie

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

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

`getCell(row, column)`

Zwraca podaną 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 względem zakresu.
`column`	`Integer`	Kolumna komórki względem zakresu.

Powroty

Range – zakres zawierający jedną komórkę o określonych współrzędnych.

Upoważnienie

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

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

`getColumn()`

Zwraca pozycję kolumny początkowej dla tego zakresu.

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

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

Powroty

Integer – pozycja kolumny początkowej zakresu w arkuszu kalkulacyjnym.

Upoważnienie

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

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

`getDataRegion()`

Zwraca kopię zakresu rozwiniętego w 4 kartach Direction, aby pokryć wszystkie sąsiednie komórki zawierające dane. Jeśli zakres jest otoczony pustymi komórkami, nie licząc tych znajdujących się wzdłuż przekątnych, zwracany jest sam zakres. Przypomina to wybór zakresu i wpisywanie w edytorze 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());

Powroty

Range – region danych zakresu lub zakres dla całego arkusza kalkulacyjnego.

Upoważnienie

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

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

`getDataRegion(dimension)`

Zwraca kopię zakresu rozwiniętego Direction.UP i Direction.DOWN, jeśli podany wymiar to Dimension.ROWS, lub Direction.NEXT i Direction.PREVIOUS, jeśli wymiar to Dimension.COLUMNS. Rozszerzanie zakresu polega na wykrywaniu danych obok zakresu uporządkowanego jak tabela. Rozszerzony zakres obejmuje wszystkie sąsiednie komórki z danymi w określonym wymiarze (łącznie z granicami tabeli). Jeśli pierwotny zakres jest otoczony pustymi komórkami na określonym wymiarze, sam zakres jest zwracany. Ta metoda przypomina wybór zakresu i wpisanie w edytorze tekstu Ctrl+Space (kolumny) lub Shift+Space (wiersze) 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, po którym ma zostać poszerzony zakres.

Powroty

Range – region danych zakresu lub zakres obejmujący każdą kolumnę bądź każdy wiersz objęty zakresem oryginalnym.

Upoważnienie

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

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

`getDataSourceFormula()`

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

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

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

// Gets the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

Powroty

DataSourceFormula – DataSourceFormula dla komórki.

Upoważnienie

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

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

`getDataSourceFormulas()`

Zwraca wartości DataSourceFormula dla komórek w zakresie.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

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

// Gets the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Powroty

DataSourceFormula[] – tablica DataSourceFormula s.

Upoważnienie

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

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

`getDataSourcePivotTables()`

Pobiera wszystkie tabele przestawne źródła danych przecinające zakres.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

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

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Powroty

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

Upoważnienie

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

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

`getDataSourceTables()`

Pobiera wszystkie tabele źródeł danych przecinające zakres.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

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

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

Powroty

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

Upoważnienie

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

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

`getDataSourceUrl()`

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

Code.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();
}

piechart.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>

Powroty

String – adres URL dla tego zakresu jako źródło danych, który można przekazywać do innych interfejsów API, np. wykresów.

Upoważnienie

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

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

`getDataTable()`

Zwraca dane wewnątrz tego obiektu jako tabela DataTable.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

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

// Gets the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

Powroty

DataTable – dane w formie tabeli;

`getDataTable(firstRowIsHeader)`

Zwraca dane z tego zakresu w postaci tabeli DataTable.

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.

Powroty

DataTable – dane w formie tabeli danych.

Upoważnienie

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

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

`getDataValidation()`

Zwraca regułę sprawdzania poprawności danych dla lewej górnej komórki zakresu. Jeśli w komórce nie ustawiono sprawdzania poprawności danych, ta metoda zwraca wartość 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.')
}

Powroty

DataValidation – reguła sprawdzania poprawności danych dla lewej górnej komórki zakresu.

Upoważnienie

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

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

`getDataValidations()`

Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie. Jeśli dla danej komórki nie ustawiono sprawdzania poprawności danych, 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);

Powroty

DataValidation[][] – dwuwymiarowa tablica z regułami sprawdzania poprawności danych powiązanymi z komórkami w zakresie.

Upoważnienie

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

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

`getDeveloperMetadata()`

Pobiera metadane dewelopera powiązane z tym zakresem.

// 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 metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

Powroty

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

Upoważnienie

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

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

`getDisplayValue()`

Zwraca wartość wyświetlaną w lewej górnej komórce zakresu. Wartość to String. Wyświetlana wartość uwzględnia formatowanie daty, godziny i waluty, w tym formaty zastosowane automatycznie przez ustawienia regionalne arkusza kalkulacyjnego. Puste komórki zwracają pusty ciąg znaków.

// 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 A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

Powroty

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

Upoważnienie

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

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

`getDisplayValues()`

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

Zwraca dwuwymiarową tablicę wyświetlanych wartości, indeksowanych według wiersza, a następnie kolumny. Wartościami są obiekty String. Wyświetlana wartość uwzględnia formatowanie daty, godziny i waluty, w tym formaty stosowane automatycznie przez ustawienia regionalne arkusza kalkulacyjnego. Puste komórki są reprezentowane przez pusty ciąg znaków w tablicy. Pamiętaj, że indeks zakresu zaczyna się od 1, 1, a 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]);

Powroty

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

Upoważnienie

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

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

`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();

Powroty

Filter – filtr.

Upoważnienie

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

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

`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());

Powroty

Color – kolor czcionki lewej górnej komórki zakresu.

Upoważnienie

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

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

`getFontColorObjects()`

Zwraca kolory czcionek w komórkach zakresu.

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());
  }
}

Powroty

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

Upoważnienie

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

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

`getFontFamilies()`

Zwraca rodziny czcionek dla komórek 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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getFontFamily()`

Zwraca rodzinę czcionek 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.getFontFamily());

Powroty

String – rodzina czcionek danej komórki.

Upoważnienie

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

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

`getFontLine()`

Pobiera styl linii z 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());

Powroty

String – wiersz czcionki.

Upoważnienie

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

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

`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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getFontSize()`

Zwraca rozmiar czcionki w punktach rozmiaru 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());

Powroty

Integer – rozmiar czcionki w punktach.

Upoważnienie

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

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

`getFontSizes()`

Zwraca rozmiar czcionki w komórkach 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]);
  }
}

Powroty

Integer[][] – dwuwymiarowa tablica z rozmiarami czcionek tekstu powiązanego z komórkami w zakresie.

Upoważnienie

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

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

`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());

Powroty

String – styl czcionki tekstu w komórce.

Upoważnienie

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

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

`getFontStyles()`

Zwraca style czcionek w komórkach zakresu.

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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getFontWeight()`

Zwraca grubość czcionki (zwykłą/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());

Powroty

String – grubość czcionki tekstu w komórce.

Upoważnienie

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

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

`getFontWeights()`

Zwraca grubość czcionek w komórkach zakresu.

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]);
  }
}

Powroty

String[][] – dwuwymiarowa tablica grubości czcionek tekstu powiązanego z komórkami w zakresie.

Upoważnienie

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

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

`getFormula()`

Zwraca formułę (w notacji A1) dla 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());

Powroty

String – formuła w komórce.

Upoważnienie

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

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

`getFormulaR1C1()`

Zwraca formułę (notacja R1C1) dla danej komórki lub null, jeśli nie ma jej wcale.

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

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

Powroty

String – formuła w notacji R1C1.

Upoważnienie

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

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

`getFormulas()`

Zwraca formuły (notacja A1) dla komórek w zakresie. Wpisy w tablicy 2D to puste ciągi znaków w komórkach 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]);
  }
}

Powroty

String[][] – dwuwymiarowa tablica formuł w formacie ciągu znaków.

Upoważnienie

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

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

`getFormulasR1C1()`

Zwraca formuły (notacja R1C1) dla komórek w zakresie. Wpisy w tablicy 2D mają wartość null w przypadku komórek bez formuły.

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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getGridId()`

Zwraca identyfikator siatki arkusza nadrzędnego zakresu. Identyfikatory to losowe nieujemne wartości liczby całkowitej.

// 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());

Powroty

Integer – identyfikator siatki arkusza nadrzędnego.

Upoważnienie

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

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

`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());

Powroty

Integer – wysokość zakresu.

Upoważnienie

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

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

`getHorizontalAlignment()`

Zwraca wyrównanie tekstu w poziomie (do lewej/do środka/do prawej) 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.getHorizontalAlignment());

Powroty

String – wyrównanie tekstu w komórce w poziomie.

Upoważnienie

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

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

`getHorizontalAlignments()`

Zwraca wyrównanie poziome 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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getLastColumn()`

Zwraca pozycję końcową kolumny.

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

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

Powroty

Integer – końcowa pozycja kolumny zakresu w arkuszu kalkulacyjnym.

Upoważnienie

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

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

`getLastRow()`

Zwraca końcową pozycję wiersza.

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

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

Powroty

Integer – końcowa pozycja wiersza zakresu w arkuszu kalkulacyjnym.

Upoważnienie

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

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

`getMergedRanges()`

Zwraca tablicę obiektów Range reprezentujących scalone komórki, które znajdują się w całości w bieżącym zakresie lub zawierają co najmniej jedną komórkę w bieżącym zakresie.

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());
}

Powroty

Range[] – tablica obiektów Range reprezentujących scalone komórki pokrywające się z zakresem.

`getNextDataCell(direction)`

Począwszy od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w podanym kierunku, który jest krawędzią sąsiadującego zakresu komórek z danymi, lub komórki znajdującej się na krawędzi arkusza kalkulacyjnego w tym kierunku. Jest to odpowiednik wpisania 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 należy znaleźć następną komórkę brzegową regionu danych.

Powroty

Range – komórka obszaru danych lub komórka na krawędzi arkusza kalkulacyjnego.

Upoważnienie

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

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

`getNote()`

Zwraca notatkę powiązaną z podanym zakresem.

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

Logger.log(range.getNote());

Powroty

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

Upoważnienie

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

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

`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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getNumColumns()`

Zwraca liczbę kolumn w tym zakresie.

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

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

Powroty

Integer – liczba kolumn w tym zakresie.

Upoważnienie

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

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

`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());

Powroty

Integer – liczba wierszy w tym zakresie.

Upoważnienie

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

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

`getNumberFormat()`

Pobierz formatowanie liczby lub daty z lewej górnej komórki danego zakresu. Zwrócone wzorce formatów są opisane w dokumentacji interfejsu Arkuszy Google.

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

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

Powroty

String – format liczbowy lewej górnej komórki zakresu.

Upoważnienie

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

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

`getNumberFormats()`

Zwraca liczbę lub format daty dla komórek w zakresie. Zwrócone wzorce formatu zostały opisane w dokumentacji interfejsuSheets 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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getRichTextValue()`

Zwraca wartość tekstu sformatowanego dla lewej górnej komórki 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());

Powroty

RichTextValue – wartość tekstu sformatowanego z lewej górnej komórki zakresu lub null, jeśli wartość komórki nie jest tekstem.

Upoważnienie

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

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

`getRichTextValues()`

Zwraca wartości z tekstu sformatowanego w komórkach 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());
  }
}

Powroty

RichTextValue[][] – dwuwymiarowa tablica wartości z tekstem sformatowanym.

Upoważnienie

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

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

`getRow()`

Zwraca pozycję wiersza dla tego zakresu. Identyczna z wartością getRowIndex().

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

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

Powroty

Integer – pozycja wiersza zakresu.

Upoważnienie

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

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

`getRowIndex()`

Zwraca pozycję wiersza dla tego zakresu. Identyczna z wartością getRow().

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

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

Powroty

Integer – pozycja wiersza zakresu.

Upoważnienie

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

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

Zobacz też

getRow()

`getSheet()`

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

// 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

Powroty

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

Upoważnienie

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

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

`getTextDirection()`

Zwraca kierunek tekstu dla lewej górnej komórki zakresu. Zwraca wartość null, jeśli kierunek tekstu komórki został określony przez automatyczne wykrywanie.

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

Powroty

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

Upoważnienie

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

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

`getTextDirections()`

Zwraca kierunek tekstu dla komórek w zakresie. Pozycje w tablicy 2D dla komórek z włączonym automatycznym wykrywaniem mają wartość null.

// 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]);
  }
}

Powroty

TextDirection[][] – dwuwymiarowa tablica kierunków tekstu.

Upoważnienie

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

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

`getTextRotation()`

Zwraca ustawienia rotacji tekstu dla lewej górnej komórki zakresu.

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

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

Powroty

TextRotation – ustawienia rotacji tekstu.

Upoważnienie

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

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

`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);
  }
}

Powroty

TextRotation[][] – dwuwymiarowa tablica obrotów tekstu powiązanych z komórkami w zakresie.

Upoważnienie

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

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

`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);

Powroty

TextStyle – styl tekstu lewej górnej komórki zakresu.

Upoważnienie

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

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

`getTextStyles()`

Zwraca style tekstu w komórkach 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]);
  }
}

Powroty

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

Upoważnienie

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

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

`getValue()`

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

// 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

Powroty

Object – wartość w danej komórce.

Upoważnienie

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

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

`getValues()`

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

Zwraca dwuwymiarową tablicę wartości indeksowanych według wiersza, a następnie kolumny. W zależności od wartości komórki mogą być one typu Number, Boolean, Date lub String. Puste komórki są reprezentowane przez pusty ciąg znaków w tablicy. Pamiętaj, że indeks zakresu zaczyna się od 1, 1, a 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 przypadku aplikacji internetowych wartość Date nie jest dozwolonym parametrem. getValues() nie zwraca danych do aplikacji internetowej, jeśli zakres zawiera komórkę z wartością Date. Zamiast tego przekształć wszystkie wartości pobrane z arkusza w obsługiwany element podstawowy JavaScript, taki jak Number, Boolean lub String.

Powroty

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

Upoważnienie

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

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

`getVerticalAlignment()`

Zwraca wyrównanie w pionie (do góry/do środka/do dołu) 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());

Powroty

String – wyrównanie tekstu w komórce w pionie.

Upoważnienie

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

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

`getVerticalAlignments()`

Zwraca wyrównanie pionowe 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]);
  }
}

Powroty

String[][] – dwuwymiarowa tablica wyrównań w pionie tekstu powiązanego z komórkami w zakresie.

Upoważnienie

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

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

`getWidth()`

Zwraca szerokość zakresu w kolumnach.

// 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

Powroty

Integer – liczba kolumn w zakresie.

Upoważnienie

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

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

`getWrap()`

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

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

Logger.log(range.getWrap());

Powroty

Boolean – określa, czy tekst w komórce jest zawijany.

Upoważnienie

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

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

`getWrapStrategies()`

Zwraca strategie zawijania tekstu w komórkach 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]);
  }
}

Powroty

WrapStrategy[][] – dwuwymiarowa tablica strategii zawijania tekstu.

Upoważnienie

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

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

`getWrapStrategy()`

Zwraca strategię zawijania tekstu dla lewej górnej komórki zakresu.

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

Powroty

WrapStrategy – strategia zawijania tekstu lewej górnej komórki zakresu.

Upoważnienie

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

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

`getWraps()`

Zwraca, czy tekst w komórkach jest zawijany. Aby uzyskać bardziej szczegółową strategię zawijania tekstu, użyj parametru 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);
    }
  }
}

Powroty

Boolean[][] – dwuwymiarowa tablica wyrównań w pionie tekstu powiązanego z komórkami w zakresie.

Upoważnienie

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

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

`insertCells(shiftDimension)`

Wstawia do tego zakresu puste komórki. Nowe komórki zachowają formatowanie występujące w komórkach zajmujących wcześniej ten zakres. Dotychczasowe dane w arkuszu wzdłuż podanego wymiaru zostaną przeniesione poza wstawiony zakres.

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, wzdłuż którego mają być przesuwane istniejące dane.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`insertCheckboxes()`

Wstawia pola wyboru w każdej komórce w zakresie z zaznaczoną wartością true i odznaczoną false. Ustawia wartość wszystkich komórek w zakresie na false.

var 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();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`insertCheckboxes(checkedValue)`

Wstawia pola wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem znaków, jeśli nie jest zaznaczone. Ustawia pusty ciąg znaków w każdej komórce w zakresie.

var 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ść pola wyboru sprawdzania poprawności danych.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Wstawia pola wyboru do każdej komórki w zakresie skonfigurowanych przy użyciu niestandardowych wartości stanów zaznaczonego i odznaczonego. Ustawia wartość każdej komórki w zakresie na niestandardową wartość niezaznaczoną.

var 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ść pola wyboru sprawdzania poprawności danych.
`uncheckedValue`	`Object`	Odznaczona wartość sprawdzania poprawności danych pola wyboru.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`isBlank()`

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

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

Logger.log(range.isBlank());

Powroty

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

Upoważnienie

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

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

`isChecked()`

Zwraca, czy wszystkie komórki w zakresie mają stan pola wyboru „zaznaczone”. Zwraca wartość null, jeśli niektóre komórki są zaznaczone, a pozostałe odznaczone lub jeśli w przypadku niektórych komórek nie ma zweryfikowanego pola wyboru.

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();

Powroty

Boolean – true, jeśli wszystkie komórki w zakresie są zaznaczone, false, jeśli wszystkie komórki w zakresie są odznaczone, lub null, jeśli jakaś z komórek jest odznaczona lub nie ma włączonej weryfikacji danych pola wyboru.

Upoważnienie

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

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

`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 wartość true. W przypadku zakresów 3:7 i A1:5, które na końcu zakresu są powiązane tylko z konkretnymi wierszami, ta metoda zwraca false.

 // 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

Powroty

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

Upoważnienie

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

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

`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 wartość true. W przypadku zakresów B:B i A1:C, które na końcu zakresu są powiązane tylko z konkretnymi kolumnami, ta metoda zwraca false.

// 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

Powroty

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

Upoważnienie

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

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

`isPartOfMerge()`

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

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();

Powroty

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 ograniczony tylko do wiersza na początku zakresu, ta metoda zwraca wartość false.

// 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

Powroty

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

Upoważnienie

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

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

`isStartRowBounded()`

Określa, czy początek 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 początku zakresu, ta metoda zwraca wartość true. W przypadku zakresu B:B, który na początku zakresu jest ograniczony tylko do konkretnej kolumny, ta metoda zwraca wartość false.

// 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:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

Powroty

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

Upoważnienie

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

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

`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();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`mergeAcross()`

Scal komórki z zakresu we wszystkich kolumnach zakresu.

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();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`mergeVertically()`

Scala ze sobą 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();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`moveTo(target)`

Wytnij i wklej (format i wartości) z tego zakresu 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 chcesz skopiować ten zakres. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.

Upoważnienie

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

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

`offset(rowOffset, columnOffset)`

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

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 oznaczają wiersze w górę od lewej górnej komórki zakresu.
`columnOffset`	`Integer`	Liczba kolumn na prawo od lewej górnej komórki zakresu. Wartości ujemne oznaczają kolumny na lewo od lewej górnej komórki zakresu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

`offset(rowOffset, columnOffset, numRows)`

Zwraca nowy zakres odnoszący się do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz z podaną wysokością 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 oznaczają wiersze w górę od lewej górnej komórki zakresu.
`columnOffset`	`Integer`	Liczba kolumn na prawo od lewej górnej komórki zakresu. Wartości ujemne oznaczają kolumny na lewo od lewej górnej komórki zakresu.
`numRows`	`Integer`	Wysokość w wierszach nowego zakresu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

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

Zwraca nowy zakres odnoszący się do bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz przy podanej wysokości i szerokości 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 oznaczają wiersze w górę od lewej górnej komórki zakresu.
`columnOffset`	`Integer`	Liczba kolumn na prawo od lewej górnej komórki zakresu. Wartości ujemne oznaczają kolumny na lewo od lewej górnej komórki zakresu.
`numRows`	`Integer`	Wysokość w wierszach nowego zakresu.
`numColumns`	`Integer`	Szerokość w kolumnach nowego zakresu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

`protect()`

Tworzy obiekt, który może chronić zakres przed edytowaniem – z wyjątkiem użytkowników, którzy mają odpowiednie uprawnienia. Dopóki skrypt nie zmieni listy edytorów zakresu (przez 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 Protection.setDomainEdit(editable)), uprawnienia powielają uprawnienia z arkusza kalkulacyjnego, co w efekcie oznacza, że zakres pozostaje niechroniony. 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 wieloma zakresami chronionymi, a jeden z nich uniemożliwia konkretnemu użytkownikowi jej edycję, użytkownik ten nie może 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);
}

Powroty

Protection – obiekt reprezentujący ustawienia zabezpieczeń.

Upoważnienie

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

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

`randomize()`

Powoduje losową kolejność wierszy w danym zakresie.

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

// Randomizes the range
range.randomize();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`removeCheckboxes()`

Usuwa wszystkie pola wyboru z zakresu. Czyści funkcję sprawdzania poprawności danych w każdej komórce i usuwa dodatkowo jej wartość, jeśli komórka zawiera zaznaczoną lub niezaznaczoną wartość.

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

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

var 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();

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`removeDuplicates()`

Usuwa wiersze z tego zakresu, które zawierają wartości będące duplikatami wartości we wszystkich poprzednich wierszach. Wiersze z identycznymi wartościami, ale różną wielkością liter, formatowaniem lub formułami są uznawane za duplikaty. Ta metoda usuwa też zduplikowane wiersze 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 duplicate rows in the range.
range.removeDuplicates();

Powroty

Range – zakres wynikowy po usunięciu duplikatów. Rozmiar zakresu jest zmniejszany o 1 wiersz na każdy usunięty wiersz.

Upoważnienie

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

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

`removeDuplicates(columnsToCompare)`

Usuwa wiersze z tego zakresu, które zawierają wartości w określonych kolumnach, które są duplikatami wartości z poprzedniego wiersza. Wiersze z identycznymi wartościami, ale różną wielkością liter, formatowaniem lub formułami są uznawane za duplikaty. Ta metoda usuwa też zduplikowane wiersze 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 przeanalizowania pod kątem zduplikowanych wartości. Jeśli nie podasz żadnych kolumn, analizowane będą wszystkie kolumny pod kątem duplikatów.

Powroty

Range – zakres wynikowy po usunięciu duplikatów. Rozmiar zakresu jest zmniejszany o 1 wiersz na każdy usunięty wiersz.

Upoważnienie

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

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

`setBackground(color)`

Określa 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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`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`	Ustawiony kolor tła; wartość `null` resetuje kolor tła.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setBackgroundObjects(color)`

Ustawia prostokątną siatkę z kolorami 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` resetują kolor.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setBackgroundRGB(red, green, blue)`

Ustawia kolor tła za pomocą wartości RGB (liczby całkowite od 0 do 255 włącznie).

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`	Wartość czerwona w notacji RGB.
`green`	`Integer`	Wartość zielona w notacji RGB.
`blue`	`Integer`	Wartość niebieska w notacji RGB.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setBackgrounds(color)`

Ustawia prostokątną siatkę z kolorami 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'`). Wartości `null` resetują kolor.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setBorder(top, left, bottom, right, vertical, horizontal)`

Ustawia właściwość obramowania. Prawidłowe wartości to true (włączony), false (wyłączony) 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 pionowe, `false` – brak, `null` – bez zmian.
`horizontal`	`Boolean`	`true` – obramowanie wewnętrzne, `false` – brak, `null` – bez zmian.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Określa właściwości obramowania z kolorem lub stylem. Prawidłowe wartości to true (włączony), false (wyłączony) i null (bez zmian). W przypadku koloru użyj wartości Kolor 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 pionowe, `false` – brak, `null` – bez zmian.
`horizontal`	`Boolean`	`true` – obramowanie wewnętrzne, `false` – brak, `null` – bez zmian.
`color`	`String`	Kolor w notacji CSS (np. `'#ffffff'` lub `'white'`), a kolor domyślny (czarny) – `null`.
`style`	`BorderStyle`	Styl obramowania, `null` – styl domyślny (ciągły).

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`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`	Ustawiona reguła sprawdzania poprawności danych lub `null`, która usuwa sprawdzanie poprawności danych.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setDataValidations(rules)`

Ustawia reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie. Ta metoda korzysta z dwuwymiarowej tablicy weryfikacji danych, indeksowanych 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ł sprawdzania poprawności danych do ustawienia. Wartości `null` usuwają funkcję sprawdzania poprawności danych.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontColor(color)`

Określa 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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontColorObject(color)`

Ustawia kolor czcionki w danym zakresie.

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`	Ustawiony kolor czcionki; wartość `null` resetuje kolor.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontColorObjects(colors)`

Ustawia prostokątną siatkę z kolorami czcionek (muszą 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` resetują kolor czcionki.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontColors(colors)`

Ustawia prostokątną siatkę z kolorami czcionek (muszą pasować do wymiarów tego zakresu). Kolory są podane 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'`). Wartości `null` resetują kolor.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontFamilies(fontFamilies)`

Ustawia prostokątną siatkę rodzin czcionek (muszą pasować do wymiarów tego zakresu). Przykładowe rodziny czcionek to „ Shorts” lub „HVE”.

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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontFamily(fontFamily)`

Ustawia rodzinę czcionek, np. „admob” lub „Hkowa”.

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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontLine(fontLine)`

Ustawia styl czcionki w danym zakresie ('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 czcionki.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontLines(fontLines)`

Ustawia prostokątną siatkę stylów linii (muszą 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 czcionek (`'underline'`, `'line-through'` lub `'none'`); wartości `null` resetują styl linii czcionki.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontSize(size)`

Ustawia rozmiar czcionki w punktach.

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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontSizes(sizes)`

Ustawia prostokątną siatkę rozmiarów czcionek (muszą pasować do wymiarów tego zakresu). 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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontStyle(fontStyle)`

Ustaw styl czcionki dla 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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontStyles(fontStyles)`

Ustawia prostokątną siatkę stylów czcionek (muszą 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 fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parametry

Nazwa	Typ	Opis
`fontStyles`	`Object[][]`	Dwuwymiarowa tablica stylów czcionek, `'italic'` lub `'normal'`; wartości `null` resetują styl czcionki.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontWeight(fontWeight)`

Ustaw grubość czcionki dla danego zakresu (normalny/pogrubiony).

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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFontWeights(fontWeights)`

Ustawia prostokątną siatkę grubości czcionek (muszą 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 tablica grubości czcionek `'bold'` lub `'normal'`. Wartości `null` resetują grubość czcionki.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFormula(formula)`

Aktualizuje formułę w tym zakresie. 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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFormulaR1C1(formula)`

Aktualizuje formułę w tym zakresie. 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 znaków.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFormulas(formulas)`

Ustawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu). Podane formuły muszą być zapisane w notacji A1. Ta metoda korzysta z dwuwymiarowej tablicy formuł zindeksowanej według wiersza, a następnie 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[][]`	Dwukierunkowa tablica ciągów formuł.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setFormulasR1C1(formulas)`

Ustawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu). Podane formuły muszą być 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[][]`	Dwukierunkowa tablica formuł w formacie R1C1.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setHorizontalAlignment(alignment)`

Ustaw wyrównanie w poziomie (od lewej do prawej) dla danego zakresu (do lewej/do środka/do prawej).

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 (`'left'`, `'center'` lub `'normal'`). Wartość `null` resetuje wyrównanie.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setHorizontalAlignments(alignments)`

Ustawia prostokątną siatkę z wyrównaniami w poziomie. Patrz: 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[][]`	Dwukierunkowa tablica wyrównań `'left'`, `'center'` lub `'normal'`. Wartość `null` resetuje wyrównanie.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

Zobacz też

setHorizontalAlignment(alignment)

`setNote(note)`

Ustawia w notatce podaną 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ść nuty ustawiona w zakresie. Wartość `null` usuwa notatkę.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setNotes(notes)`

Ustawia prostokątną siatkę notatek (muszą 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[][]`	Dwukierunkowa tablica notatek. Wartości `null` usuwają notatkę.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

Zobacz też

setNote(note)

`setNumberFormat(numberFormat)`

Ustawia format liczby lub daty dla danego ciągu formatowania. Akceptowane wzorce formatów zostały opisane w dokumentacji interfejsu Arkuszy Google.

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`	Ciąg w formacie liczby.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setNumberFormats(numberFormats)`

Ustawia prostokątną siatkę z formatami liczb lub dat (muszą pasować do wymiarów tego zakresu). Wartości to ciągi znaków w wzorcu formatu zgodnie z opisem w dokumentacji interfejsu Arkuszy Google.

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[][]`	Dwukierunkowa tablica formatów liczb.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setRichTextValue(value)`

Ustawia wartość tekstu sformatowanego 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ść tekstu sformatowanego.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setRichTextValues(values)`

Ustawia prostokątną siatkę wartości z 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.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setShowHyperlink(showHyperlink)`

Określa, czy zakres ma wyświetlać hiperlinki.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.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 A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

Parametry

Nazwa	Typ	Opis
`showHyperlink`	`Boolean`	Określa, czy hiperlink ma być wyświetlany.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setTextDirection(direction)`

Ustawia kierunek tekstu w komórkach zakresu. Jeśli określony kierunek to null, zostanie on wywnioskowany, 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`	Żądany kierunek tekstu. Jeśli ma wartość `null`, kierunek jest ustalany przed ustawieniem.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setTextDirections(directions)`

Ustawia prostokątną siatkę ze wskazówkami dotyczącymi tekstu. Jeśli określony kierunek to null, zostanie on wywnioskowany, 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[][]`	Żądane kierunki tekstu. Jeśli określony kierunek to `null`, jest on ustalany przed ustawieniem.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setTextRotation(degrees)`

Określa ustawienia rotacji tekstu dla komórek w zakresie. Dane wejściowe odpowiadają kątowi między standardową orientacją tekstu a żądaną orientacją. Wartość 0 oznacza, że tekst jest ustawiony w standardowej orientacji.

W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są wykonywane w lewo, a od prawej do lewej – w prawo.

// 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`	Wybrany kąt między orientacją standardową a żądaną. W przypadku tekstu od lewej do prawej kąty dodatnie są wykonywane w kierunku przeciwnym do ruchu wskazówek zegara.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setTextRotation(rotation)`

Określa ustawienia rotacji tekstu dla komórek w zakresie.

// 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`	Wybrane ustawienia rotacji tekstu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setTextRotations(rotations)`

Ustawia prostokątną siatkę z rotacjami 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[][]`	Wybrane ustawienia rotacji tekstu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setTextStyle(style)`

Ustawia styl tekstu w komórkach w zakresie.

// 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`	Żądany styl tekstu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`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[][]`	Odpowiednie style tekstu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setValue(value)`

Ustawia wartość zakresu. Wartością może być liczba, ciąg znaków, wartość logiczna lub data. Jeśli zaczyna się od '=', jest interpretowane 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ść zakresu.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setValues(values)`

Ustawia prostokątną siatkę wartości (muszą pasować do wymiarów tego zakresu). Jeśli wartość zaczyna się od =, jest interpretowana jako formuła.

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[][]`	Dwukierunkowa tablica wartości.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setVerticalAlignment(alignment)`

Ustaw wyrównanie w pionie (od góry do dołu) dla danego 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 (`'top'`, `'middle'` lub `'bottom'`). Wartość `null` resetuje wyrównanie.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setVerticalAlignments(alignments)`

Ustawia prostokątną siatkę z wyrównaniami pionowymi (muszą 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[][]`	Dwukierunkowa tablica wyrównań `'top'`, `'middle'` lub `'bottom'`. Wartość `null` resetuje wyrównanie.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

Zobacz też

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Określa, czy tekst w komórkach w zakresie ma być ułożony w stos. Jeśli tekst jest ułożony w pionie, ustawienie jego obrotu jest ignorowane.

// 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 się nakładać na stos.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setWrap(isWrapEnabled)`

Ustawia zawijanie komórek w danym zakresie.

Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, by wyświetlić całą ich zawartość. Komórki z wyłączoną zawijaniem wyświetlają się w jak największym stopniu bez zmiany rozmiaru i wyświetlania wielu wierszy.

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 tekst ma być zawijany.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`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[][]`	Pożądane strategie pakowania.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setWrapStrategy(strategy)`

Ustawia strategię zawijania tekstu w komórkach w zakresie.

// 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`	Docelowa strategia pakowania.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`setWraps(isWrapEnabled)`

Ustawia prostokątną siatkę z zasadami zawijania słów (muszą pasować do wymiarów tego zakresu). Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, tak aby wyświetlały się w całości. Komórki z wyłączonym zawijaniem wyświetlają się w jak największym stopniu 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 ze zmiennymi zawijania, które określają, czy zawijać tekst w komórce.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

Zobacz też

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Zmienia głębokość grupowania kolumn o określoną kwotę.

W ten sposób można tworzyć, modyfikować i usuwać grupy, które przecinają zakres. W przypadku delta tworzone są lub modyfikowane grupy, a w przypadku delta grupy zostały zniszczone lub zmodyfikowane.

Nie ma to wpływu na głębokość grupy poniżej zera lub powyżej 8.

Jeśli column group control position to BEFORE, podczas próby przesunięcia głębokości pierwszego wiersza wystąpi 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 którą ma zostać zmieniona głębokość grupy kolumn w tym zakresie.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Rzuty

Error – przy próbie przesunięcia głębokości pierwszej kolumny, gdy w pozycji sterującej znajduje się GroupControlTogglePosition.BEFORE;

Upoważnienie

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

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

`shiftRowGroupDepth(delta)`

Zmienia głębokość grupowania wierszy o określoną kwotę.

Nie ma to wpływu na głębokość grupy poniżej zera lub powyżej 8.

Jeśli row group control position ma wartość BEFORE, podczas próby przesunięcia głębokości pierwszego wiersza występuje 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`	Kwota, o którą ma zostać zmieniona głębokość grupy wierszy w tym zakresie.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Rzuty

Error – przy próbie zmiany głębokości pierwszego wiersza, gdy pozycja kontrolna to GroupControlTogglePosition.BEFORE

Upoważnienie

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

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

`sort(sortSpecObj)`

Sortuje komórki w danym zakresie według określonej 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, według których należy posortować dane.

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`splitTextToColumns()`

Dzieli kolumnę tekstu na kilka kolumn na podstawie automatycznie wykrytego 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 z co najmniej jednym z tych zakresów:

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

`splitTextToColumns(delimiter)`

Dzieli kolumnę z tekstem na kilka kolumn przy użyciu podanego 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, według którego zostanie podzielony.

Upoważnienie

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

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

`splitTextToColumns(delimiter)`

Dzieli kolumnę z tekstem 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`	Gotowy separator, według którego chcesz podzielić dane.

Upoważnienie

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

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

`trimWhitespace()`

Usuwa odstępy (np. spacje, znaki tabulacji lub nowe wiersze) z każdej komórki w tym zakresie. Usuwa wszystkie odstępy z początku i końca tekstu w każdej komórce oraz zmniejsza kolejne odstępy między kolejnymi znakami do 1 spacji.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

`uncheck()`

Zmienia stan pól wyboru w zakresie na „odznaczone”. Ignoruje komórki w zakresie, które obecnie nie zawierają skonfigurowanej ani zaznaczonej, ani niezaznaczonej wartości.

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

Powroty

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

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

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

Wycofane metody

`getFontColor()`

Wycofano. 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());

Powroty

String – kolor czcionki w notacji CSS (np. '#ffffff' lub 'white').

Upoważnienie

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

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

`getFontColors()`

Wycofano. 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]);
  }
}

Powroty

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

Upoważnienie

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

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