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

Class Range

uzyskiwać dostęp do zakresów arkusza kalkulacyjnego i je modyfikować; Zakres może być pojedynczą komórką w arkuszu lub grupą sąsiadujących komórek w arkuszu.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`Range`	Ustawia określony zakres jako `active range`, a lewą górną komórkę w zakresie jako `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 o określonym kluczu, wartości i widoczności.
`applyColumnBanding()`	`Banding`	Stosuje do zakresu domyślny motyw pasków kolumn.
`applyColumnBanding(bandingTheme)`	`Banding`	Stosuje do zakresu określony motyw pasków kolumn.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje do zakresu określony motyw pasów kolumn z określonymi ustawieniami nagłówka i stopki.
`applyRowBanding()`	`Banding`	Stosuje do zakresu domyślny motyw naprzemiennego kolorowania wierszy.
`applyRowBanding(bandingTheme)`	`Banding`	Stosuje do zakresu określony motyw paskowania wierszy.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje do zakresu określony motyw pasków wierszy z określonymi ustawieniami nagłówka i stopki.
`autoFill(destination, series)`	`void`	Wypełnia komórkę `destinationRange` danymi na podstawie danych z tego zakresu.
`autoFillToNeighbor(series)`	`void`	Oblicza zakres, który ma zostać wypełniony nowymi danymi, na podstawie sąsiednich komórek i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych w nim zawartych.
`breakApart()`	`Range`	Ponownie podzielić wszystkie komórki wielokolumnowe w zakresie na pojedyncze 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`	Czyści zakres zawartości, formatu, reguł sprawdzania poprawności danych lub komentarzy zgodnie z określonymi opcjami zaawansowanymi.
`clearContent()`	`Range`	Czyści zawartość zakresu, pozostawiając formatowanie bez zmian.
`clearDataValidations()`	`Range`	Usuwa reguły sprawdzania poprawności danych z zakresu.
`clearFormat()`	`Range`	Czyści formatowanie w tym zakresie.
`clearNote()`	`Range`	Usuwa notatkę z wybranej komórki lub komórek.
`collapseGroups()`	`Range`	Zwijanie wszystkich grup, które w całości mieszczą się w zakresie.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do podanej lokalizacji.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do podanej lokalizacji.
`copyTo(destination)`	`void`	Kopiuje dane z zakresu komórek do innego zakresu komórek.
`copyTo(destination, copyPasteType, transposed)`	`void`	Kopiuje dane z zakresu komórek do innego zakresu komórek.
`copyTo(destination, options)`	`void`	Kopiuje dane 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 pustą tabelę przestawną źródła danych na podstawie źródła danych, zakotwiczoną w pierwszej komórce tego zakresu.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Tworzy pustą tabelę źródła danych na podstawie źródła danych, zakotwiczoną w pierwszej komórce tego zakresu.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca DeveloperMetadataFinderApi do wyszukiwania 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 zakresu `sourceData` zakotwiczonego w pierwszej komórce tego zakresu.
`createTextFinder(findText)`	`TextFinder`	Tworzy narzędzie do wyszukiwania tekstu w zakresie, które może wyszukiwać i zamieniać tekst w tym zakresie.
`deleteCells(shiftDimension)`	`void`	Usuwa ten zakres komórek.
`expandGroups()`	`Range`	Rozwija zwinięte grupy, których zakres lub przełącznik sterujący przecina ten zakres.
`getA1Notation()`	`String`	Zwraca opis zakresu w formie ciągu znaków w notacji A1.
`getBackground()`	`String`	Zwraca kolor tła lewej górnej komórki w zakresie (np. `'#ffffff'`).
`getBackgroundObject()`	`Color`	Zwraca kolor tła lewej górnej komórki w zakresie.
`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 zakresy, które są stosowane do dowolnych komórek w tym zakresie.
`getCell(row, column)`	`Range`	Zwraca daną komórkę w zakresie.
`getColumn()`	`Integer`	Zwraca pozycję początkową kolumny w tym zakresie.
`getDataRegion()`	`Range`	Zwraca kopię zakresu rozszerzonego w 4 kierunkach głównych `Direction`, aby obejmował wszystkie sąsiednie komórki zawierające dane.
`getDataRegion(dimension)`	`Range`	Zwraca kopię zakresu rozszerzonego o `Direction.UP` i `Direction.DOWN`, jeśli określony wymiar to `Dimension.ROWS`, lub o `Direction.NEXT` i `Direction.PREVIOUS`, jeśli wymiar to `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Zwraca `DataSourceFormula` pierwszej komórki w zakresie lub `null`, jeśli komórka nie zawiera formuły źródła danych.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Zwraca `DataSourceFormula` komórek w zakresie.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródeł danych, które przecinają zakres.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych, które przecinają zakres.
`getDataSourceUrl()`	`String`	Zwraca adres URL danych w tym zakresie, którego można użyć do tworzenia wykresów i zapytań.
`getDataTable()`	`DataTable`	Zwraca dane w tym obiekcie jako DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Zwraca dane z tego zakresu jako DataTable.
`getDataValidation()`	`DataValidation`	Zwraca regułę sprawdzania poprawności danych dla komórki w lewym górnym rogu 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 wyświetlaną wartość lewej górnej komórki w zakresie.
`getDisplayValues()`	`String[][]`	Zwraca prostokątną siatkę wartości dla tego zakresu.
`getFilter()`	`Filter`	Zwraca filtr w arkuszu, do którego należy ten zakres, lub `null`, jeśli w arkuszu nie ma filtra.
`getFontColorObject()`	`Color`	Zwraca kolor czcionki komórki w lewym górnym rogu zakresu.
`getFontColorObjects()`	`Color[][]`	Zwraca kolory czcionki komórek w zakresie.
`getFontFamilies()`	`String[][]`	Zwraca rodziny czcionek komórek w zakresie.
`getFontFamily()`	`String`	Zwraca rodzinę czcionek komórki w lewym górnym rogu zakresu.
`getFontLine()`	`String`	Pobiera styl linii komórki w lewym górnym rogu zakresu (`'underline'`, `'line-through'` lub `'none'`).
`getFontLines()`	`String[][]`	Pobiera styl linii komórek w zakresie (`'underline'`, `'line-through'` lub `'none'`).
`getFontSize()`	`Integer`	Zwraca rozmiar czcionki w punktach komórki w lewym górnym rogu zakresu.
`getFontSizes()`	`Integer[][]`	Zwraca rozmiary czcionek komórek w zakresie.
`getFontStyle()`	`String`	Zwraca styl czcionki (`'italic'` lub `'normal'`) komórki w lewym górnym rogu zakresu.
`getFontStyles()`	`String[][]`	Zwraca style czcionki komórek w zakresie.
`getFontWeight()`	`String`	Zwraca grubość czcionki (normalna/pogrubiona) komórki w lewym górnym rogu zakresu.
`getFontWeights()`	`String[][]`	Zwraca wagi czcionek komórek w zakresie.
`getFormula()`	`String`	Zwraca formułę (w notacji A1) dla lewej górnej komórki zakresu lub pusty ciąg znaków, jeśli komórka jest pusta lub nie zawiera formuły.
`getFormulaR1C1()`	`String`	Zwraca formułę (w notacji R1C1) dla danej komórki lub `null`, jeśli nie ma formuły.
`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 poziome tekstu (do lewej, do środka lub do prawej) w komórce w lewym górnym rogu zakresu.
`getHorizontalAlignments()`	`String[][]`	Zwraca poziome wyrównanie komórek w zakresie.
`getLastColumn()`	`Integer`	Zwraca pozycję kolumny końcowej.
`getLastRow()`	`Integer`	Zwraca pozycję wiersza końcowego.
`getMergedRanges()`	`Range[]`	Zwraca tablicę obiektów `Range` reprezentujących scalone komórki, które w całości znajdują się w bieżącym zakresie lub zawierają co najmniej 1 komórkę w bieżącym zakresie.
`getNextDataCell(direction)`	`Range`	Zaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w podanym kierunku, która jest krawędzią ciągłego zakresu komórek zawierających dane lub komórką 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`	Pobiera formatowanie liczb lub dat z lewej górnej komórki danego zakresu.
`getNumberFormats()`	`String[][]`	Zwraca formaty liczb lub dat dla komórek w zakresie.
`getRichTextValue()`	`RichTextValue`	Zwraca wartość sformatowanego tekstu z lewej górnej komórki zakresu lub `null`, jeśli wartość komórki nie jest tekstem.
`getRichTextValues()`	`RichTextValue[][]`	Zwraca wartości sformatowanego tekstu dla komórek w zakresie.
`getRow()`	`Integer`	Zwraca pozycję wiersza dla tego zakresu.
`getRowIndex()`	`Integer`	Zwraca pozycję wiersza dla tego zakresu.
`getSheet()`	`Sheet`	Zwraca arkusz, do którego należy ten zakres.
`getTextDirection()`	`TextDirection`	Zwraca kierunek tekstu w lewej górnej komórce zakresu.
`getTextDirections()`	`TextDirection[][]`	Zwraca kierunek tekstu w komórkach w zakresie.
`getTextRotation()`	`TextRotation`	Zwraca ustawienia obrotu tekstu w lewej górnej komórce zakresu.
`getTextRotations()`	`TextRotation[][]`	Zwraca ustawienia obrotu tekstu w komórkach w zakresie.
`getTextStyle()`	`TextStyle`	Zwraca styl tekstu lewej górnej komórki zakresu.
`getTextStyles()`	`TextStyle[][]`	Zwraca style tekstu komórek w zakresie.
`getValue()`	`Object`	Zwraca wartość lewej górnej komórki w zakresie.
`getValues()`	`Object[][]`	Zwraca prostokątną siatkę wartości dla tego zakresu.
`getVerticalAlignment()`	`String`	Zwraca wyrównanie w pionie (do góry, do środka lub do dołu) komórki w lewym górnym rogu zakresu.
`getVerticalAlignments()`	`String[][]`	Zwraca pionowe wyrównanie komórek w zakresie.
`getWidth()`	`Integer`	Zwraca szerokość zakresu w kolumnach.
`getWrap()`	`Boolean`	Zwraca informację, czy tekst w komórce jest zawijany.
`getWrapStrategies()`	`WrapStrategy[][]`	Zwraca strategie zawijania tekstu w komórkach w zakresie.
`getWrapStrategy()`	`WrapStrategy`	Zwraca strategię zawijania tekstu w lewej górnej komórce zakresu.
`getWraps()`	`Boolean[][]`	Zwraca informację o tym, czy tekst w komórkach jest zawijany.
`insertCells(shiftDimension)`	`Range`	Wstawia puste komórki w tym zakresie.
`insertCheckboxes()`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z symbolem `true` dla zaznaczonych i `false` dla niezaznaczonych.
`insertCheckboxes(checkedValue)`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonych komórek i pustym ciągiem znaków dla niezaznaczonych.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z wartościami niestandardowymi dla stanów zaznaczonego i niezaznaczonego.
`isBlank()`	`Boolean`	Zwraca `true`, jeśli zakres jest całkowicie pusty.
`isChecked()`	`Boolean`	Zwraca informację, 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 określonym 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 określonym wierszem.
`merge()`	`Range`	Łączy komórki w zakresie w jeden blok.
`mergeAcross()`	`Range`	Scal komórki w zakresie w kolumnach zakresu.
`mergeVertically()`	`Range`	Scala komórki w zakresie.
`moveTo(target)`	`void`	Wytnij i wklej (zarówno format, jak i wartości) z tego zakresu do zakresu docelowego.
`offset(rowOffset, columnOffset)`	`Range`	Zwraca nowy zakres, który jest przesunięty względem tego zakresu o podaną liczbę wierszy i kolumn (która może być ujemna).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Zwraca nowy zakres względny względem bieżącego zakresu, którego lewy górny punkt jest przesunięty względem bieżącego zakresu o podaną liczbę wierszy i kolumn, a wysokość jest podana w komórkach.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Zwraca nowy zakres względny względem bieżącego zakresu, którego lewy górny punkt jest przesunięty względem bieżącego zakresu o podaną liczbę wierszy i kolumn, a wysokość i szerokość są podane w komórkach.
`protect()`	`Protection`	Tworzy obiekt, który chroni zakres przed edycją przez użytkowników bez uprawnień.
`randomize()`	`Range`	Losuje kolejność wierszy w podanym zakresie.
`removeCheckboxes()`	`Range`	Usuwa wszystkie pola wyboru z zakresu.
`removeDuplicates()`	`Range`	Usuwa wiersze w tym zakresie, które zawierają wartości będące duplikatami wartości z dowolnego poprzedniego wiersza.
`removeDuplicates(columnsToCompare)`	`Range`	Usuwa wiersze w tym zakresie, które zawierają w określonych kolumnach wartości będące duplikatami wartości z poprzedniego wiersza.
`setBackground(color)`	`Range`	Ustawia kolor tła wszystkich komórek w zakresie w notacji CSS (np. `'#ffffff'` lub `'white'`).
`setBackgroundObject(color)`	`Range`	Ustawia kolor tła wszystkich komórek w zakresie.
`setBackgroundObjects(color)`	`Range`	Ustawia prostokątną siatkę kolorów tła (musi pasować do wymiarów tego zakresu).
`setBackgroundRGB(red, green, blue)`	`Range`	Ustawia tło na podany kolor przy użyciu wartości RGB (liczb całkowitych z zakresu od 0 do 255 włącznie).
`setBackgrounds(color)`	`Range`	Ustawia prostokątną siatkę kolorów tła (musi pasować do wymiarów tego zakresu).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Ustawia właściwość obramowania.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Ustawia właściwość obramowania z kolorem lub stylem.
`setDataValidation(rule)`	`Range`	Ustawia 1 regułę weryfikacji danych dla wszystkich komórek w zakresie.
`setDataValidations(rules)`	`Range`	Ustawia reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
`setFontColor(color)`	`Range`	Ustawia kolor czcionki w notacji CSS (np. `'#ffffff'` lub `'white'`).
`setFontColorObject(color)`	`Range`	Ustawia kolor czcionki w podanym zakresie.
`setFontColorObjects(colors)`	`Range`	Ustawia prostokątną siatkę kolorów czcionek (musi pasować do wymiarów tego zakresu).
`setFontColors(colors)`	`Range`	Ustawia prostokątną siatkę kolorów czcionek (musi pasować do wymiarów tego zakresu).
`setFontFamilies(fontFamilies)`	`Range`	Ustawia prostokątną siatkę rodzin czcionek (musi pasować do wymiarów tego zakresu).
`setFontFamily(fontFamily)`	`Range`	Ustawia rodzinę czcionek, np. „Arial” lub „Helvetica”.
`setFontLine(fontLine)`	`Range`	Ustawia styl linii czcionki w podanym zakresie (`'underline'`, `'line-through'` lub `'none'`).
`setFontLines(fontLines)`	`Range`	Ustawia prostokątną siatkę stylów linii (musi odpowiadać wymiarom tego zakresu).
`setFontSize(size)`	`Range`	Ustawia rozmiar czcionki, który jest rozmiarem w punktach.
`setFontSizes(sizes)`	`Range`	Ustawia prostokątną siatkę rozmiarów czcionek (musi 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 (musi pasować do wymiarów tego zakresu).
`setFontWeight(fontWeight)`	`Range`	Ustaw grubość czcionki w danym zakresie (normalna lub pogrubiona).
`setFontWeights(fontWeights)`	`Range`	Ustawia prostokątną siatkę grubości czcionki (musi pasować do wymiarów tego zakresu).
`setFormula(formula)`	`Range`	Aktualizuje formułę dla tego zakresu.
`setFormulaR1C1(formula)`	`Range`	Aktualizuje formułę dla tego zakresu.
`setFormulas(formulas)`	`Range`	Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu).
`setFormulasR1C1(formulas)`	`Range`	Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu).
`setHorizontalAlignment(alignment)`	`Range`	Ustawia wyrównanie poziome (od lewej do prawej) w podanym zakresie (lewe/środkowe/prawe).
`setHorizontalAlignments(alignments)`	`Range`	Ustawia prostokątną siatkę wyrównań poziomych.
`setNote(note)`	`Range`	Ustawia notatkę na podaną wartość.
`setNotes(notes)`	`Range`	Ustawia prostokątną siatkę notatek (musi pasować do wymiarów tego zakresu).
`setNumberFormat(numberFormat)`	`Range`	Ustawia format liczby lub daty na podany ciąg formatowania.
`setNumberFormats(numberFormats)`	`Range`	Ustawia prostokątną siatkę formatów liczb lub dat (musi pasować do wymiarów tego zakresu).
`setRichTextValue(value)`	`Range`	Ustawia wartość sformatowanego tekstu dla komórek w zakresie.
`setRichTextValues(values)`	`Range`	Ustawia prostokątną siatkę wartości sformatowanego tekstu.
`setShowHyperlink(showHyperlink)`	`Range`	Określa, czy zakres ma zawierać hiperlinki.
`setTextDirection(direction)`	`Range`	Ustawia kierunek tekstu w komórkach w zakresie.
`setTextDirections(directions)`	`Range`	Ustawia prostokątną siatkę kierunków tekstu.
`setTextRotation(degrees)`	`Range`	Ustawia ustawienia rotacji tekstu w komórkach w zakresie.
`setTextRotation(rotation)`	`Range`	Ustawia ustawienia rotacji tekstu w komórkach w zakresie.
`setTextRotations(rotations)`	`Range`	Ustawia prostokątną siatkę obrotów tekstu.
`setTextStyle(style)`	`Range`	Ustawia styl tekstu dla komórek 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 (musi być zgodna z wymiarami 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ę wyrównań w pionie (musi odpowiadać wymiarom tego zakresu).
`setVerticalText(isVertical)`	`Range`	Określa, czy tekst w komórkach w zakresie ma być ułożony w stos.
`setWrap(isWrapEnabled)`	`Range`	Ustaw zawijanie komórek w podanym 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ę zasad zawijania wierszy (musi odpowiadać wymiarom tego zakresu).
`shiftColumnGroupDepth(delta)`	`Range`	Zmienia głębokość grupowania kolumn w zakresie o określoną wartość.
`shiftRowGroupDepth(delta)`	`Range`	Zmienia głębokość grupowania wierszy w zakresie o określoną wartość.
`sort(sortSpecObj)`	`Range`	Sortuje komórki w podanym 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ę tekstu na kilka kolumn, używając określonego ciągu znaków jako niestandardowego ogranicznika.
`splitTextToColumns(delimiter)`	`void`	Dzieli kolumnę tekstu na kilka kolumn na podstawie określonego separatora.
`trimWhitespace()`	`Range`	Usuwa białe znaki (takie jak spacje, tabulatory lub nowe wiersze) w każdej komórce w tym zakresie.
`uncheck()`	`Range`	Zmienia stan pól wyboru w zakresie na „niezaznaczone”.

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 lewą górną komórkę w zakresie jako current cell.

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

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

Powrót

Range – ten zakres do łączenia.

`activateAsCurrentCell()`

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

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

Jeśli określona komórka nie występuje w żadnym istniejącym zakresie, bieżące zaznaczenie zostanie usunięte, a komórka stanie się bieżącą komórką i aktywnym zakresem.

Uwaga: określony Range musi składać się z jednej komórki, w przeciwnym razie zostanie zgłoszony wyjątek.

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

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addDeveloperMetadata(key)`

Dodaje do zakresu metadane dewelopera z 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.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addDeveloperMetadata(key, visibility)`

Dodaje do zakresu metadane dewelopera z określonym kluczem 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.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addDeveloperMetadata(key, value)`

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

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

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

// Gets row 2 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.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`addDeveloperMetadata(key, value, visibility)`

Dodaje do zakresu metadane dewelopera o określonym kluczu, 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.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`applyColumnBanding()`

Stosuje do zakresu domyślny motyw pasków kolumn. Domyślnie pasmo ma kolor nagłówka, ale nie ma koloru stopki.

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

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

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

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

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

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

Powrót

Banding – nowe pasma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`applyColumnBanding(bandingTheme)`

Stosuje do zakresu określony motyw pasków kolumn. Domyślnie pasma mają kolor nagłówka, ale nie mają koloru stopki.

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

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

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

// Applies 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, który ma zostać zastosowany do kolumn w zakresie.

Powrót

Banding – nowe pasma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Stosuje do zakresu określony motyw pasów kolumn 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, który ma zostać zastosowany do kolumn w zakresie.
`showHeader`	`Boolean`	Jeśli `true`, kolor nagłówka motywu z paskami jest stosowany do pierwszej kolumny.
`showFooter`	`Boolean`	Jeśli `true`, kolor stopki motywu z paskami jest stosowany do ostatniej kolumny.

Powrót

Banding – nowe pasma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`applyRowBanding()`

Stosuje do zakresu domyślny motyw naprzemiennego kolorowania wierszy. Domyślnie pasmo ma kolor nagłówka, ale nie ma koloru 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);

Powrót

Banding – pasy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`applyRowBanding(bandingTheme)`

Stosuje do zakresu określony motyw paskowania wierszy. Domyślnie pasmo ma kolor nagłówka, ale nie ma koloru 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 w wierszach w zakresie.

Powrót

Banding – nowe pasma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Stosuje do zakresu określony motyw pasków wierszy 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 w wierszach w zakresie.
`showHeader`	`Boolean`	Jeśli `true`, kolor nagłówka motywu paskowania jest stosowany do pierwszego wiersza.
`showFooter`	`Boolean`	Jeśli `true`, kolor stopki motywu pasmowego jest stosowany do ostatniego wiersza.

Powrót

Banding – nowe pasma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`autoFill(destination, series)`

Wypełnia komórkę destinationRange danymi na podstawie danych z tego zakresu. Nowe wartości są też określane przez podany seriestyp. Zakres docelowy musi zawierać ten zakres i wykraczać poza niego tylko w jednym kierunku. Na przykład poniższa formuła wypełnia zakres A1:A20 serią rosnących liczb na podstawie bieżących wartości w zakresie A1:A4:

const sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
const sourceRange = sheet.getRange('A1:A4');
// The range to fill with values.
const 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 wypełniony wartościami. Zakres docelowy powinien zawierać ten zakres i wykraczać poza niego tylko w jednym kierunku (w górę, w dół, w lewo lub w prawo).
`series`	`AutoFillSeries`	Typ serii automatycznego wypełniania, który powinien być używany 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.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`autoFillToNeighbor(series)`

Oblicza zakres, który ma zostać wypełniony nowymi danymi, na podstawie sąsiednich komórek i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych w nim zawartych. Te nowe wartości są też określane przez podany typ series.

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

Jeśli np. w A1:A20 znajduje się ciąg rosnących liczb, a ta metoda jest wywoływana w zakresie B1:B4, który zawiera ciąg dat, nowe wartości są wstawiane tylko do B5:B20. W ten sposób nowe wartości „przykleją się” do komórek zawierających wartości w kolumnie A.

const sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
const 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 automatycznego wypełniania, który powinien być używany 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.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`breakApart()`

Ponownie podzielić wszystkie komórki wielokolumnowe w zakresie na pojedyncze komórki.

Wywołanie tej funkcji w zakresie jest równoznaczne z wybraniem zakresu i kliknięciem Formatuj > Scal komórki > Cofnij scalanie.

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`canEdit()`

Określa, czy użytkownik ma uprawnienia do edytowania każdej komórki w zakresie. Właściciel arkusza kalkulacyjnego 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());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`check()`

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`clear()`

Usuwa zakres treści i formatów.

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

const range = sheet.getRange('A1:D10');
range.clear();

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`clear(options)`

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

// 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 JavaScriptu, który określa parametry zaawansowane wymienione poniżej.

Parametry zaawansowane

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`clearContent()`

Czyści zawartość zakresu, pozostawiając formatowanie bez zmian.

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

const range = sheet.getRange('A1:D10');
range.clearContent();

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`clearDataValidations()`

Usuwa reguły sprawdzania poprawności danych z zakresu.

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 zresetuje żadnych reguł formatowania liczb.

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

const range = sheet.getRange('A1:D10');
range.clearFormat();

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`clearNote()`

Usuwa notatkę z wybranej komórki lub komórek.

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

const range = sheet.getRange('A1:D10');
range.clearNote();

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`collapseGroups()`

Zwijanie wszystkich grup, które w całości mieszczą się w zakresie. Jeśli żadna grupa nie mieści się w całości w zakresie, zwijana jest najbardziej rozwinięta grupa, która częściowo mieści się w zakresie.

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

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

Skopiuj formatowanie zakresu do podanej lokalizacji. Jeśli zakres docelowy jest większy lub mniejszy niż zakres źródłowy, zakres źródłowy jest odpowiednio powtarzany lub obcinany. Pamiętaj, że ta metoda kopiuje tylko formatowanie.

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

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

const 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`	Ostatnia kolumna zakresu docelowego.
`row`	`Integer`	Pierwszy wiersz zakresu docelowego.
`rowEnd`	`Integer`	Ostatni wiersz zakresu docelowego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

getGridId()

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

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

const 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`	Ostatnia kolumna zakresu docelowego.
`row`	`Integer`	Pierwszy wiersz zakresu docelowego.
`rowEnd`	`Integer`	Ostatni wiersz zakresu docelowego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`copyTo(destination)`

Kopiuje dane z zakresu 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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres docelowy, do którego chcesz skopiować dane. Istotne jest tylko położenie lewej górnej komórki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`copyTo(destination, copyPasteType, transposed)`

Kopiuje dane z zakresu komórek do innego zakresu komórek.

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

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres docelowy, do którego chcesz skopiować dane. Istotne jest tylko położenie lewej górnej komórki.
`copyPasteType`	`CopyPasteType`	Typ określający sposób wklejania zawartości zakresu do miejsca docelowego.
`transposed`	`Boolean`	Określa, czy zakres ma być wklejony w transponowanej orientacji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`copyTo(destination, options)`

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

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

Parametry

Nazwa	Typ	Opis
`destination`	`Range`	Zakres docelowy, do którego chcesz skopiować dane. Istotne jest tylko położenie lewej górnej komórki.
`options`	`Object`	Obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej.

Parametry zaawansowane

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

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

Skopiuj zawartość zakresu do podanej lokalizacji. Jeśli zakres docelowy jest większy lub mniejszy niż zakres źródłowy, zakres źródłowy jest odpowiednio powtarzany lub obcinany.

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

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

const 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`	Ostatnia kolumna zakresu docelowego.
`row`	`Integer`	Pierwszy wiersz zakresu docelowego.
`rowEnd`	`Integer`	Ostatni wiersz zakresu docelowego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

getGridId()

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

Skopiuj zawartość zakresu do podanej lokalizacji. Jeśli zakres docelowy jest większy lub mniejszy niż zakres źródłowy, zakres źródłowy jest odpowiednio powtarzany lub obcinany.

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

const 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`	Ostatnia kolumna zakresu docelowego.
`row`	`Integer`	Pierwszy wiersz zakresu docelowego.
`rowEnd`	`Integer`	Ostatni wiersz zakresu docelowego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createDataSourcePivotTable(dataSource)`

Tworzy pustą tabelę przestawną źródła danych na podstawie źródła danych, zakotwiczoną w pierwszej komórce tego zakresu.

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

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

const 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 chcesz utworzyć tabelę przestawną.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createDataSourceTable(dataSource)`

Tworzy pustą tabelę źródła danych na podstawie źródła danych, zakotwiczoną w pierwszej komórce tego zakresu.

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

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

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

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createDeveloperMetadataFinder()`

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

Powrót

DeveloperMetadataFinder – wyszukiwarka metadanych dewelopera, która umożliwia wyszukiwanie metadanych w zakresie tego zakresu.

`createFilter()`

Tworzy filtr i stosuje go do określonego zakresu w arkuszu. W arkuszu możesz utworzyć tylko jeden filtr. Aby po utworzeniu filtra uzyskać do niego dostęp i go zmodyfikować, użyj ikony getFilter() lub Sheet.getFilter().

const ss = SpreadsheetApp.getActiveSheet();
const 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() {
  const filter = range.getFilter();
  const criteria =
      SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
  filter.setColumnFilterCriteria(2, criteria);
}

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

Tworzenie filtra tabeli przestawnej za pomocą PivotTable.addFilter(sourceDataColumn, filterCriteria)
Tworzenie filtra w arkuszu połączonym z bazą danych za pomocą DataSourceSheet.addFilter(columnName, filterCriteria)
Tworzenie filtra dla tabeli przestawnej połączonej z bazą danych za pomocą DataSourcePivotTable.addFilter(columnName, filterCriteria)

Powrót

Filter – nowy filtr.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createPivotTable(sourceData)`

Tworzy pustą tabelę przestawną z określonego zakresu sourceData zakotwiczonego w pierwszej komórce tego zakresu.

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

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

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

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

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

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

Parametry

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

Powrót

PivotTable – nowo utworzony PivotTable.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`createTextFinder(findText)`

Tworzy narzędzie do wyszukiwania tekstu w zakresie, które może wyszukiwać i zamieniać tekst w tym zakresie.

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

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

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

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

Parametry

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

Powrót

TextFinder – TextFinder dla zakresu

`deleteCells(shiftDimension)`

Usuwa ten zakres komórek. Istniejące dane w arkuszu wzdłuż podanego wymiaru są przesuwane w kierunku usuniętego zakresu.

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

const range = sheet.getRange('A1:D10');
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parametry

Nazwa	Typ	Opis
`shiftDimension`	`Dimension`	Wymiar, wzdłuż którego mają zostać przesunięte dotychczasowe dane.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`expandGroups()`

Rozwija zwinięte grupy, których zakres lub przełącznik sterujący przecina ten zakres. Lokalizacja przełącznika to indeks, w którym jest on wyświetlany, bezpośrednio przed grupą lub po niej, w zależności od ustawień. Jeśli w tej samej lokalizacji jest więcej niż jedna grupa, rozwijana jest ta, która znajduje się najbliżej powierzchni.

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getA1Notation()`

Zwraca opis zakresu w formie ciągu znaków w notacji A1.

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

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

Powrót

String – opis zakresu w notacji A1.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getBackground()`

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

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

const cell = sheet.getRange('B5');
Logger.log(cell.getBackground());

Powrót

String – kod koloru tła.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getBackgroundObject()`

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

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

const cell = sheet.getRange('B5');
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Powrót

Color – kolor tła komórki w lewym górnym rogu zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getBackgroundObjects()`

Zwraca kolory tła komórek w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getBackgrounds()`

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

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getBandings()`

Zwraca wszystkie zakresy, które są stosowane do dowolnych komórek w tym zakresie.

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

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

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

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

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

Powrót

Banding[] – wszystkie zakresy, które są stosowane do komórek w tym zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getCell(row, column)`

Zwraca daną komórkę w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getColumn()`

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

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataRegion()`

Zwraca kopię zakresu rozszerzonego w 4 kierunkach głównych Direction, aby obejmował wszystkie sąsiednie komórki zawierające dane. Jeśli zakres jest otoczony pustymi komórkami, które nie obejmują komórek na przekątnych, zwracany jest sam zakres. Jest to podobne do wybrania zakresu i wpisania Ctrl+A w edytorze.

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataRegion(dimension)`

Zwraca kopię zakresu rozszerzonego o Direction.UP i Direction.DOWN, jeśli określony wymiar to Dimension.ROWS, lub o Direction.NEXT i Direction.PREVIOUS, jeśli wymiar to Dimension.COLUMNS. Rozszerzenie zakresu następuje na podstawie wykrywania danych obok zakresu, które są uporządkowane jak tabela. Rozszerzony zakres obejmuje wszystkie sąsiednie komórki zawierające dane w określonym wymiarze, w tym granice tabeli. Jeśli oryginalny zakres jest otoczony pustymi komórkami wzdłuż określonego wymiaru, zwracany jest sam zakres. Ta metoda jest podobna do zaznaczania zakresu i wpisywania w edytorze znaku Ctrl+Space w przypadku kolumn lub Shift+Space w przypadku wierszy.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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, wzdłuż którego chcesz rozszerzyć zakres.

Powrót

Range – obszar danych zakresu lub zakres obejmujący każdą kolumnę lub każdy wiersz, na które rozciąga się pierwotny zakres.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataSourceFormula()`

Zwraca DataSourceFormula 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);

Powrót

DataSourceFormula – DataSourceFormula komórki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataSourceFormulas()`

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

Powrót

DataSourceFormula[] – tablica elementów typu DataSourceFormula.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataSourcePivotTables()`

Pobiera wszystkie tabele przestawne źródeł danych, które przecinają 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());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataSourceTables()`

Pobiera wszystkie tabele źródeł danych, które przecinają 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());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataSourceUrl()`

Zwraca adres URL danych w tym zakresie, którego można użyć do tworzenia wykresów i zapytań.

Code.gs

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

  const 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>

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataTable()`

Zwraca dane w tym obiekcie jako 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();

Powrót

DataTable – dane w postaci tabeli danych.

`getDataTable(firstRowIsHeader)`

Zwraca dane z tego zakresu jako DataTable.

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

// Calling this method with "true" sets the first line to be the title of the
// axes
const 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.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Title Here')
                  .build();

Parametry

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

Powrót

DataTable – dane w postaci tabeli danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataValidation()`

Zwraca regułę sprawdzania poprawności danych dla komórki w lewym górnym rogu 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDataValidations()`

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

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

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

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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()}`);
}

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDisplayValue()`

Zwraca wyświetlaną wartość lewej górnej komórki w zakresie. Wartość to String. Wyświetlana wartość uwzględnia formatowanie daty, godziny i waluty, w tym formaty stosowane automatycznie przez ustawienie 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());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getDisplayValues()`

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

Zwraca dwuwymiarową tablicę wyświetlanych wartości indeksowanych według wiersza, a następnie według kolumny. Wartości to obiekty String. Wyświetlana wartość uwzględnia formatowanie daty, godziny i waluty, w tym formaty stosowane automatycznie przez ustawienia regionalne arkusza kalkulacyjnego. Puste komórki są reprezentowane w tablicy przez pusty ciąg. Pamiętaj, że indeks zakresu zaczyna się od 1, 1, a tablica JavaScriptu jest indeksowana od [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.
const values =
    SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFilter()`

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

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

Powrót

Filter – filtr.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontColorObject()`

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

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

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

Powrót

Color – kolor czcionki lewej górnej komórki w zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontColorObjects()`

Zwraca kolory czcionki komórek w zakresie.

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

const results = range.getFontColorObjects();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontFamilies()`

Zwraca rodziny czcionek komórek w zakresie.

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

const results = range.getFontFamilies();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontFamily()`

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

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

Logger.log(range.getFontFamily());

Powrót

String – rodzina czcionek komórki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontLine()`

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

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

Logger.log(range.getFontLine());

Powrót

String – linia czcionki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontLines()`

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

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

const results = range.getFontLines();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontSize()`

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

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

Logger.log(range.getFontSize());

Powrót

Integer – rozmiar czcionki w punktach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontSizes()`

Zwraca rozmiary czcionek komórek w zakresie.

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

const results = range.getFontSizes();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontStyle()`

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

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

Logger.log(range.getFontStyle());

Powrót

String – styl czcionki tekstu w komórce.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontStyles()`

Zwraca style czcionki komórek w zakresie.

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

const results = range.getFontStyles();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontWeight()`

Zwraca grubość czcionki (normalna/pogrubiona) komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getFontWeight());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFontWeights()`

Zwraca wagi czcionek komórek w zakresie.

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

const results = range.getFontWeights();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 znaków, jeśli komórka jest pusta lub nie zawiera formuły.

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

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

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

Powrót

String – formuła komórki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getFormulaR1C1()`

Zwraca formułę (w notacji R1C1) dla danej komórki lub null, jeśli nie ma formuły.

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

const range = sheet.getRange('B5');
const formula = range.getFormulaR1C1();
Logger.log(formula);

Powrót

String – formuła w notacji R1C1.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 dwuwymiarowej to puste ciągi znaków w przypadku komórek bez formuły.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 dwuwymiarowej to null w przypadku komórek bez formuły.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getGridId()`

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

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

Logger.log(range.getGridId());

Powrót

Integer – identyfikator siatki arkusza nadrzędnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getHeight()`

Zwraca wysokość zakresu.

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

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

Powrót

Integer – wysokość zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getHorizontalAlignment()`

Zwraca wyrównanie poziome tekstu (do lewej, do środka lub do prawej) w komórce w lewym górnym rogu zakresu.

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

Logger.log(range.getHorizontalAlignment());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getHorizontalAlignments()`

Zwraca poziome wyrównanie komórek w zakresie.

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

const results = range.getHorizontalAlignments();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getLastColumn()`

Zwraca pozycję kolumny końcowej.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getLastRow()`

Zwraca pozycję wiersza końcowego.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getMergedRanges()`

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

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

const range = sheet.getRange('A1:B3');

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

Powrót

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

`getNextDataCell(direction)`

Zaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w podanym kierunku, która jest krawędzią ciągłego zakresu komórek zawierających dane lub komórką na krawędzi arkusza kalkulacyjnego w tym kierunku. Jest to odpowiednik wpisania w edytorze znaku Ctrl+[arrow key].

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

const 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 szukać następnej komórki na krawędzi regionu danych.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

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

Logger.log(range.getNote());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getNotes()`

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

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

const results = range.getNotes();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getNumColumns()`

Zwraca liczbę kolumn w tym zakresie.

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

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumColumns());

Powrót

Integer – liczba kolumn w tym zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getNumRows()`

Zwraca liczbę wierszy w tym zakresie.

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

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumRows());

Powrót

Integer – liczba wierszy w tym zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getNumberFormat()`

Pobiera formatowanie liczb lub dat z lewej górnej komórki danego zakresu. Zwrócone wzorce formatów są opisane w dokumentacji interfejsu Sheets API.

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

const cell = sheet.getRange('C4');
Logger.log(cell.getNumberFormat());

Powrót

String – format liczbowy komórki w lewym górnym rogu zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getNumberFormats()`

Zwraca formaty liczb lub dat dla komórek w zakresie. Wzorce zwracanych formatów są opisane w dokumentacji interfejsu Sheets API.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getRichTextValue()`

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getRichTextValues()`

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

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

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

Powrót

RichTextValue[][] – dwuwymiarowa tablica wartości sformatowanego tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getRow()`

Zwraca pozycję wiersza dla tego zakresu. Identyczna z funkcją getRowIndex().

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

const range = sheet.getRange('B2');
Logger.log(range.getRow());

Powrót

Integer – pozycja wiersza zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getRowIndex()`

Zwraca pozycję wiersza dla tego zakresu. Identyczna z funkcją getRow().

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

const range = sheet.getRange('B2');
Logger.log(range.getRowIndex());

Powrót

Integer – pozycja wiersza zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

getRow()

`getSheet()`

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTextDirection()`

Zwraca kierunek tekstu w lewej górnej komórce zakresu. Zwraca null, jeśli kierunek tekstu w komórce jest określany za pomocą automatycznego wykrywania.

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTextDirections()`

Zwraca kierunek tekstu w komórkach w zakresie. Wpisy w tablicy dwuwymiarowej to null w przypadku komórek, w których użyto automatycznego wykrywania.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTextRotation()`

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

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

const cell = sheet.getRange('A1');
Logger.log(cell.getTextRotation());

Powrót

TextRotation – ustawienia rotacji tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTextRotations()`

Zwraca ustawienia obrotu tekstu w komórkach w zakresie.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

const results = range.getTextRotations();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTextStyle()`

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTextStyles()`

Zwraca style tekstu komórek w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getValue()`

Zwraca wartość lewej górnej komórki w zakresie. Wartość może być typu Number, Boolean, Date lub String w zależności od wartości komórki. Puste komórki zwracają pusty ciąg.

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

Powrót

Object – wartość w tej komórce.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getValues()`

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

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

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

W aplikacjach internetowych wartość Date nie jest prawidłowym 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 typ pierwotny JavaScriptu, np. Number, Boolean lub String.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getVerticalAlignment()`

Zwraca wyrównanie w pionie (do góry, do środka lub do dołu) komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getVerticalAlignment());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getVerticalAlignments()`

Zwraca pionowe wyrównanie komórek w zakresie.

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

const results = range.getVerticalAlignments();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getWidth()`

Zwraca szerokość zakresu w kolumnach.

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

Powrót

Integer – liczba kolumn w zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getWrap()`

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

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

Logger.log(range.getWrap());

Powrót

Boolean – czy tekst w tej komórce jest zawijany.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getWrapStrategies()`

Zwraca strategie zawijania tekstu w komórkach w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getWrapStrategy()`

Zwraca strategię zawijania tekstu w lewej górnej komórce zakresu.

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getWraps()`

Zwraca informację o tym, czy tekst w komórkach jest zawijany. Aby uzyskać bardziej szczegółową strategię zawijania, użyj elementu getWrapStrategies().

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

const results = range.getVerticalAlignments();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertCells(shiftDimension)`

Wstawia puste komórki w tym zakresie. Nowe komórki zachowują formatowanie komórek, które wcześniej zajmowały ten zakres. Istniejące dane w arkuszu wzdłuż podanego wymiaru są przesuwane poza wstawiony zakres.

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

const range = sheet.getRange('A1:D10');
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parametry

Nazwa	Typ	Opis
`shiftDimension`	`Dimension`	Wymiar, wzdłuż którego mają zostać przesunięte dotychczasowe dane.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertCheckboxes()`

Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z symbolem true dla zaznaczonych i false dla niezaznaczonych. Ustawia wartość wszystkich komórek w zakresie na false.

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertCheckboxes(checkedValue)`

Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonych komórek i pustym ciągiem znaków dla niezaznaczonych. Ustawia wartość każdej komórki w zakresie na pusty ciąg znaków.

const 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ść zaznaczonego pola wyboru w sprawdzaniu poprawności danych.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Wstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z wartościami niestandardowymi dla stanów zaznaczonego i niezaznaczonego. Ustawia w każdej komórce w zakresie niestandardową wartość niezaznaczoną.

const 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ść zaznaczonego pola wyboru w sprawdzaniu poprawności danych.
`uncheckedValue`	`Object`	Wartość niezaznaczonego pola wyboru w przypadku weryfikacji danych.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isBlank()`

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

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

Logger.log(range.isBlank());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isChecked()`

Zwraca informację, czy wszystkie komórki w zakresie mają stan pola wyboru „zaznaczone”. Zwraca null, jeśli niektóre komórki są zaznaczone, a pozostałe nie, lub jeśli niektóre komórki nie mają weryfikacji danych pola wyboru.

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

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

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

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

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

Powrót

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 któraś z komórek jest odznaczona lub nie ma sprawdzania poprawności danych w postaci pola wyboru.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isEndColumnBounded()`

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isEndRowBounded()`

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

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isPartOfMerge()`

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

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

const range = sheet.getRange('A1:B3');

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

Powrót

Boolean – true, jeśli zakres nakłada się na scalone komórki, w przeciwnym razie zwraca wartość 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 true. W przypadku zakresu 3:7, który jest powiązany tylko z wierszem na początku zakresu, 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 start of the range is bound to a particular column and logs
// it to the console.
console.log(range.isStartColumnBounded());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`isStartRowBounded()`

Określa, czy początek zakresu jest powiązany z określonym 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 true. W przypadku zakresu B:B, który jest powiązany tylko z określoną kolumną na początku zakresu, 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 start of the range is bound to a particular row and logs it
// to the console.
console.log(range.isStartRowBounded());

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`merge()`

Łączy komórki w zakresie w jeden blok.

const sheet = SpreadsheetApp.getActiveSheet();

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`mergeAcross()`

Scal komórki w zakresie w kolumnach zakresu.

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

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`mergeVertically()`

Scala komórki w zakresie.

const sheet = SpreadsheetApp.getActiveSheet();

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`moveTo(target)`

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

// The code below moves the first 5 columns over to the 6th column
const 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. Istotna jest tylko pozycja lewej górnej komórki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`offset(rowOffset, columnOffset)`

Zwraca nowy zakres, który jest przesunięty względem tego zakresu o podaną liczbę wierszy i kolumn (która może być ujemna). Nowy zakres ma taki sam rozmiar jak pierwotny.

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

const cell = sheet.getRange('A1');

// newCell references B2
const 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 reprezentują kolumny na lewo od lewej górnej komórki zakresu.

Powrót

Range – ten zakres do łączenia.

`offset(rowOffset, columnOffset, numRows)`

Zwraca nowy zakres względny względem bieżącego zakresu, którego lewy górny punkt jest przesunięty względem bieżącego zakresu o podaną liczbę wierszy i kolumn, a wysokość jest podana w komórkach.

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

const cell = sheet.getRange('A1');

// newCell references B2:B3
const 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 reprezentują kolumny na lewo od lewej górnej komórki zakresu.
`numRows`	`Integer`	Wysokość nowego zakresu w wierszach.

Powrót

Range – ten zakres do łączenia.

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

Zwraca nowy zakres względny względem bieżącego zakresu, którego lewy górny punkt jest przesunięty względem bieżącego zakresu o podaną liczbę wierszy i kolumn, a wysokość i szerokość są podane w komórkach.

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

const cell = sheet.getRange('A1');

// newCell references B2:C3
const 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 reprezentują kolumny na lewo od lewej górnej komórki zakresu.
`numRows`	`Integer`	Wysokość nowego zakresu w wierszach.
`numColumns`	`Integer`	Szerokość nowego zakresu w kolumnach.

Powrót

Range – ten zakres do łączenia.

`protect()`

Tworzy obiekt, który chroni zakres przed edycją przez użytkowników bez uprawnień. Dopóki skrypt nie zmieni listy edytujących zakres (wywołując Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) lub ustawiając nową wartość Protection.setDomainEdit(editable)), uprawnienia będą odzwierciedlać uprawnienia samego arkusza kalkulacyjnego, co oznacza, że zakres pozostanie niechroniony. Jeśli zakres jest już chroniony, ta metoda utworzy nowy chroniony zakres, który będzie się pokrywał z dotychczasowym. Jeśli komórka jest chroniona przez kilka zakresów chronionych, a którykolwiek z nich uniemożliwia danemu użytkownikowi edytowanie komórki, użytkownik nie może jej edytować.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const 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.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Powrót

Protection – obiekt reprezentujący ustawienia ochrony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`randomize()`

Losuje kolejność wierszy w podanym zakresie.

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

// Randomizes the range
range.randomize();

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeCheckboxes()`

Usuwa wszystkie pola wyboru z zakresu. Usuwa sprawdzanie poprawności danych z każdej komórki, a dodatkowo usuwa jej wartość, jeśli zawiera ona wartość zaznaczoną lub niezaznaczoną.

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

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

const range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeDuplicates()`

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

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

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

Powrót

Range – zakres po usunięciu duplikatów. Rozmiar zakresu zmniejsza się o 1 wiersz za każdy usunięty wiersz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`removeDuplicates(columnsToCompare)`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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, wszystkie kolumny zostaną przeanalizowane pod kątem duplikatów.

Powrót

Range – zakres po usunięciu duplikatów. Rozmiar zakresu zmniejsza się o 1 wiersz za każdy usunięty wiersz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setBackground(color)`

Ustawia kolor tła wszystkich komórek w zakresie w notacji CSS (np. '#ffffff' lub 'white').

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

const range = sheet.getRange('B2:D5');
range.setBackground('red');

Parametry

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setBackgroundObject(color)`

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

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

const range = sheet.getRange('B2:D5');
range.setBackgroundObject(bgColor);

Parametry

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setBackgroundObjects(color)`

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

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

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

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

const cell = sheet.getRange('B5:C6');
cell.setBackgroundObjects(colors);

Parametry

Nazwa	Typ	Opis
`color`	`Color[][]`	Dwuwymiarowa tablica kolorów; wartości `null` resetują kolor.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setBackgroundRGB(red, green, blue)`

Ustawia tło na podany kolor przy użyciu wartości RGB (liczb całkowitych z zakresu od 0 do 255 włącznie).

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

const 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ść czerwonego w notacji RGB.
`green`	`Integer`	Wartość koloru zielonego w notacji RGB.
`blue`	`Integer`	Wartość niebieskiego w notacji RGB.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setBackgrounds(color)`

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

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

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

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

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

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

const 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` w przypadku wewnętrznych obramowań pionowych, `false` w przypadku braku obramowań, `null` w przypadku braku zmian.
`horizontal`	`Boolean`	`true` w przypadku wewnętrznych obramowań poziomych, `false` w przypadku braku obramowań, `null` w przypadku braku zmian.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

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

Ustawia właściwość obramowania z kolorem lub stylem. Prawidłowe wartości to true (włączone), false (wyłączone) i null (bez zmian). W przypadku koloru użyj notacji CSS (np. '#ffffff' lub 'white').

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

const 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` w przypadku wewnętrznych obramowań pionowych, `false` w przypadku braku obramowań, `null` w przypadku braku zmian.
`horizontal`	`Boolean`	`true` w przypadku wewnętrznych obramowań poziomych, `false` w przypadku braku obramowań, `null` w przypadku braku zmian.
`color`	`String`	Kolor w notacji CSS (np. `'#ffffff'` lub `'white'`), `null` dla koloru domyślnego (czarnego).
`style`	`BorderStyle`	Styl obramowania, `null` w przypadku stylu domyślnego (ciągłego).

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setDataValidation(rule)`

Ustawia 1 regułę weryfikacji danych dla wszystkich komórek w zakresie.

// Set the data validation rule for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
`rule`	`DataValidation`	Reguła sprawdzania poprawności danych do ustawienia lub `null`, aby usunąć sprawdzanie poprawności danych.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setDataValidations(rules)`

Ustawia reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie. Ta metoda przyjmuje dwuwymiarową tablicę weryfikacji danych indeksowaną najpierw według wiersza, a potem według kolumny. Wymiary tablicy muszą odpowiadać wymiarom zakresu.

// Set the data validation rules for Sheet1!A1:B5 to require a value from
// Sheet2!A1:A10.
const destinationRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
const sourceRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
const rules = destinationRange.getDataValidations();
for (let i = 0; i < rules.length; i++) {
  for (let 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ą sprawdzanie poprawności danych.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontColor(color)`

Ustawia kolor czcionki w notacji CSS (np. '#ffffff' lub 'white').

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

const cell = sheet.getRange('B2');
cell.setFontColor('red');

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor czcionki w notacji CSS (np. `'#ffffff'` lub `'white'`); wartość `null` resetuje kolor.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontColorObject(color)`

Ustawia kolor czcionki w podanym zakresie.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();

const cell = sheet.getRange('B2');
cell.setFontColor(color);

Parametry

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontColorObjects(colors)`

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

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

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

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

const cell = sheet.getRange('B5:C6');
cell.setFontColorObjects(colors);

Parametry

Nazwa	Typ	Opis
`colors`	`Color[][]`	Dwuwymiarowa tablica kolorów; `null` resetuje kolor czcionki.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontColors(colors)`

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

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

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontFamilies(fontFamilies)`

Ustawia prostokątną siatkę rodzin czcionek (musi pasować do wymiarów tego zakresu). Przykłady rodzin czcionek to „Arial” i „Helvetica”.

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

const fonts = [
  ['Arial', 'Helvetica', 'Verdana'],
  ['Courier New', 'Arial', 'Helvetica'],
];

const cell = sheet.getRange('B2:D3');
cell.setFontFamilies(fonts);

Parametry

Nazwa	Typ	Opis
`fontFamilies`	`Object[][]`	Dwuwymiarowa tablica rodzin czcionek; wartości `null` resetują rodzinę czcionek.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontFamily(fontFamily)`

Ustawia rodzinę czcionek, np. „Arial” lub „Helvetica”.

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

const cell = sheet.getRange('B2');
cell.setFontFamily('Helvetica');

Parametry

Nazwa	Typ	Opis
`fontFamily`	`String`	Rodzina czcionek do ustawienia. Wartość `null` resetuje rodzinę czcionek.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontLine(fontLine)`

Ustawia styl linii czcionki w podanym zakresie ('underline', 'line-through' lub 'none').

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

const cell = sheet.getRange('B2');
cell.setFontLine('line-through');

Parametry

Nazwa	Typ	Opis
`fontLine`	`String`	Styl linii czcionki, czyli `'underline'`, `'line-through'` lub `'none'`. Wartość `null` resetuje styl linii czcionki.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontLines(fontLines)`

Ustawia prostokątną siatkę stylów linii (musi odpowiadać wymiarom tego zakresu).

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

// The size of the two-dimensional array must match the size of the range.
const fontLines = [['underline', 'line-through', 'none']];

const range = sheet.getRange('B2:D2');
range.setFontLines(fontLines);

Parametry

Nazwa	Typ	Opis
`fontLines`	`Object[][]`	Dwuwymiarowa tablica stylów linii czcionki (`'underline'`, `'line-through'` lub `'none'`); wartości `null` resetują styl linii czcionki.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontSize(size)`

Ustawia rozmiar czcionki, który jest rozmiarem w punktach.

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

const cell = sheet.getRange('B2');
cell.setFontSize(20);

Parametry

Nazwa	Typ	Opis
`size`	`Integer`	Rozmiar czcionki w punktach.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontSizes(sizes)`

Ustawia prostokątną siatkę rozmiarów czcionek (musi pasować do wymiarów tego zakresu). Rozmiary są podane w punktach.

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

// The size of the two-dimensional array must match the size of the range.
const fontSizes = [[16, 20, 24]];

const range = sheet.getRange('B2:D2');
range.setFontSizes(fontSizes);

Parametry

Nazwa	Typ	Opis
`sizes`	`Object[][]`	Dwuwymiarowa tablica rozmiarów.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontStyle(fontStyle)`

Ustaw styl czcionki dla danego zakresu ('italic' lub 'normal').

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

const cell = sheet.getRange('B2');
cell.setFontStyle('italic');

Parametry

Nazwa	Typ	Opis
`fontStyle`	`String`	Styl czcionki, `'italic'` lub `'normal'`; wartość `null` resetuje styl czcionki.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontStyles(fontStyles)`

Ustawia prostokątną siatkę stylów czcionek (musi pasować do wymiarów tego zakresu).

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

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['italic', 'normal']];

const range = sheet.getRange('B2:C2');
range.setFontStyles(fontStyles);

Parametry

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontWeight(fontWeight)`

Ustaw grubość czcionki w danym zakresie (normalna lub pogrubiona).

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

const cell = sheet.getRange('B2');
cell.setFontWeight('bold');

Parametry

Nazwa	Typ	Opis
`fontWeight`	`String`	Grubość czcionki, `'bold'` lub `'normal'`; wartość `null` resetuje grubość czcionki.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFontWeights(fontWeights)`

Ustawia prostokątną siatkę grubości czcionki (musi pasować do wymiarów tego zakresu). Przykładem grubości czcionki jest „bold”.

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

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['bold', 'bold', 'normal']];

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Parametry

Nazwa	Typ	Opis
`fontWeights`	`Object[][]`	Dwuwymiarowa tablica grubości czcionki, `'bold'` lub `'normal'`; wartości `null` resetują grubość czcionki.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFormula(formula)`

Aktualizuje formułę dla tego zakresu. Podana formuła musi być w notacji A1.

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

const cell = sheet.getRange('B5');
cell.setFormula('=SUM(B3:B4)');

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Ciąg znaków reprezentujący formułę do ustawienia w komórce.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFormulaR1C1(formula)`

Aktualizuje formułę dla tego zakresu. Podana formuła musi być w notacji R1C1.

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

const 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 tekstowego.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFormulas(formulas)`

Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu). Podane formuły muszą być w notacji A1. Ta metoda przyjmuje dwuwymiarową tablicę formuł indeksowaną najpierw według wiersza, a potem według kolumny. Wymiary tablicy muszą odpowiadać wymiarom zakresu.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Parametry

Nazwa	Typ	Opis
`formulas`	`String[][]`	Dwuwymiarowa tablica ciągów tekstowych z formułami.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setFormulasR1C1(formulas)`

Ustawia prostokątną siatkę formuł (musi pasować do wymiarów tego zakresu). Podane formuły muszą być zapisane w notacji R1C1.

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

// This creates formulas for a row of sums, followed by a row of averages.
const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])';
const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])';

// The size of the two-dimensional array must match the size of the range.
const formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove],
];

const cell = sheet.getRange('B5:D6');
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parametry

Nazwa	Typ	Opis
`formulas`	`String[][]`	Dwuwymiarowa tablica formuł w formacie R1C1.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setHorizontalAlignment(alignment)`

Ustawia wyrównanie poziome (od lewej do prawej) w podanym zakresie (lewe/środkowe/prawe).

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

const cell = sheet.getRange('B2');
cell.setHorizontalAlignment('center');

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie, czyli `'left'`, `'center'` lub `'normal'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setHorizontalAlignments(alignments)`

Ustawia prostokątną siatkę wyrównań poziomych. Zobacz setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
const horizontalAlignments = [['left', 'right', 'center']];

const range = sheet.getRange('B2:D2');
range.setHorizontalAlignments(horizontalAlignments);

Parametry

Nazwa	Typ	Opis
`alignments`	`Object[][]`	Dwuwymiarowa tablica wyrównań, która może zawierać wartości `'left'`, `'center'` lub `'normal'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

setHorizontalAlignment(alignment)

`setNote(note)`

Ustawia notatkę na podaną wartość.

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

const cell = sheet.getRange('B2');
cell.setNote('This is a note');

Parametry

Nazwa	Typ	Opis
`note`	`String`	Wartość notatki do ustawienia dla zakresu. Wartość `null` usuwa notatkę.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setNotes(notes)`

Ustawia prostokątną siatkę notatek (musi pasować do wymiarów tego zakresu).

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

// The size of the two-dimensional array must match the size of the range.
const notes = [
  ['it goes', 'like this', 'the fourth, the fifth'],
  ['the minor fall', 'and the', 'major lift'],
];

const cell = sheet.getRange('B2:D3');
cell.setNotes(notes);

Parametry

Nazwa	Typ	Opis
`notes`	`Object[][]`	Dwuwymiarowa tablica notatek; wartości `null` usuwają notatkę.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

setNote(note)

`setNumberFormat(numberFormat)`

Ustawia format liczby lub daty na podany ciąg formatowania. Akceptowane wzorce formatów są opisane w dokumentacji interfejsu Google Sheets API.

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

const cell = sheet.getRange('B2');
// Always show 3 decimal points
cell.setNumberFormat('0.000');

Parametry

Nazwa	Typ	Opis
`numberFormat`	`String`	Ciąg znaków formatu liczbowego.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setNumberFormats(numberFormats)`

Ustawia prostokątną siatkę formatów liczb lub dat (musi pasować do wymiarów tego zakresu). Wartości to ciągi wzorców formatu opisane w dokumentacji interfejsu Sheets API.

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

// The size of the two-dimensional array must match the size of the range.
const formats = [['0.000', '0,000,000', '$0.00']];

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Parametry

Nazwa	Typ	Opis
`numberFormats`	`Object[][]`	Dwuwymiarowa tablica formatów liczb.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setRichTextValue(value)`

Ustawia wartość sformatowanego tekstu dla komórek w zakresie.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello"
// bolded.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Parametry

Nazwa	Typ	Opis
`value`	`RichTextValue`	Żądana wartość sformatowanego tekstu.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setRichTextValues(values)`

Ustawia prostokątną siatkę wartości sformatowanego tekstu.

// Sets the cells in range A1:A2 to have Rich Text values.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const 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 sformatowanego tekstu.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setShowHyperlink(showHyperlink)`

Określa, czy zakres ma zawierać 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ć widoczny.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w zakresie. Jeśli określony kierunek to null, kierunek jest wywnioskowany, a następnie ustawiany.

// Sets right-to-left text direction for the range.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametry

Nazwa	Typ	Opis
`direction`	`TextDirection`	Kierunek tekstu. Jeśli `null` kierunek jest wywnioskowany przed ustawieniem.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTextDirections(directions)`

Ustawia prostokątną siatkę kierunków tekstu. Jeśli określony kierunek to null, kierunek jest wywnioskowany, a następnie ustawiany.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextDirections());

Parametry

Nazwa	Typ	Opis
`directions`	`TextDirection[][]`	Kierunek tekstu. Jeśli określony kierunek to `null`, jest on wywnioskowany przed ustawieniem.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTextRotation(degrees)`

Ustawia ustawienia rotacji tekstu w komórkach w zakresie. Wartość wejściowa odpowiada kątowi między standardową orientacją tekstu a orientacją docelową. Wartość 0 oznacza, że tekst jest ustawiony w standardowej orientacji.

W przypadku kierunku tekstu od lewej do prawej dodatnie kąty są mierzone w kierunku przeciwnym do ruchu wskazówek zegara, a w przypadku kierunku od prawej do lewej – w kierunku zgodnym z ruchem wskazówek zegara.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setTextRotation(45);

Parametry

Nazwa	Typ	Opis
`degrees`	`Integer`	Żądany kąt między orientacją standardową a orientacją docelową. W przypadku tekstu od lewej do prawej kąty dodatnie są mierzone w kierunku przeciwnym do ruchu wskazówek zegara.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTextRotation(rotation)`

Ustawia ustawienia rotacji tekstu w komórkach w zakresie.

// Sets all cell's in range B2:D4 to have the same text rotation settings as
// cell A1.
const sheet = SpreadsheetApp.getActiveSheet();

const rotation = sheet.getRange('A1').getTextRotation();

sheet.getRange('B2:D4').setTextRotation(rotation);

Parametry

Nazwa	Typ	Opis
`rotation`	`TextRotation`	wybrane ustawienia obracania tekstu;

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTextRotations(rotations)`

Ustawia prostokątną siatkę obrotów tekstu.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Parametry

Nazwa	Typ	Opis
`rotations`	`TextRotation[][]`	wybrane ustawienia obracania tekstu;

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTextStyle(style)`

Ustawia styl tekstu dla komórek w zakresie.

// Sets the cells in range C5:D6 to have underlined size 15 font.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('C5:D6');
const style =
    SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build();
range.setTextStyle(style);

Parametry

Nazwa	Typ	Opis
`style`	`TextStyle`	Żądany styl tekstu.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setTextStyles(styles)`

Ustawia prostokątną siatkę stylów tekstu.

// Sets text styles for cells in range A1:B2
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const 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[][]`	Pożądane style tekstu.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setValue(value)`

Ustawia wartość zakresu. Wartość może być liczbą, ciągiem znaków, wartością logiczną lub datą. Jeśli zaczyna się od znaku '=', jest interpretowane jako formuła.

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

const cell = sheet.getRange('B2');
cell.setValue(100);

Parametry

Nazwa	Typ	Opis
`value`	`Object`	Wartość zakresu.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setValues(values)`

Ustawia prostokątną siatkę wartości (musi być zgodna z wymiarami tego zakresu). Jeśli wartość zaczyna się od znaku =, jest interpretowana jako formuła.

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

// The size of the two-dimensional array must match the size of the range.
const values = [['2.000', '1,000,000', '$2.99']];

const range = sheet.getRange('B2:D2');
range.setValues(values);

Parametry

Nazwa	Typ	Opis
`values`	`Object[][]`	Dwuwymiarowa tablica wartości.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setVerticalAlignment(alignment)`

Ustaw wyrównanie w pionie (od góry do dołu) dla danego zakresu (góra/środek/dół).

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

const cell = sheet.getRange('B2');
cell.setVerticalAlignment('middle');

Parametry

Nazwa	Typ	Opis
`alignment`	`String`	Wyrównanie, czyli `'top'`, `'middle'` lub `'bottom'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setVerticalAlignments(alignments)`

Ustawia prostokątną siatkę wyrównań w pionie (musi odpowiadać wymiarom tego zakresu).

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

// The size of the two-dimensional array must match the size of the range.
const alignments = [['top', 'middle', 'bottom']];

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parametry

Nazwa	Typ	Opis
`alignments`	`Object[][]`	Dwuwymiarowa tablica wyrównań, która może zawierać wartości `'top'`, `'middle'` lub `'bottom'`. Wartość `null` resetuje wyrównanie.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Określa, czy tekst w komórkach w zakresie ma być ułożony w stos. Jeśli tekst jest ułożony pionowo, ustawienie obrotu tekstu w stopniach jest ignorowane.

// Sets all cell's in range B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Parametry

Nazwa	Typ	Opis
`isVertical`	`Boolean`	Określa, czy tekst ma być ułożony w stos.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setWrap(isWrapEnabled)`

Ustaw zawijanie komórek w podanym zakresie.

Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z zawijaniem wyłączonym wyświetlają jak najwięcej treści bez zmiany rozmiaru i przechodzenia do wielu wierszy.

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

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parametry

Nazwa	Typ	Opis
`isWrapEnabled`	`Boolean`	Określa, czy tekst ma być zawijany.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setWrapStrategies(strategies)`

Ustawia prostokątną siatkę strategii zawijania.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setWrapStrategies(range1.getWrapStrategies());

Parametry

Nazwa	Typ	Opis
`strategies`	`WrapStrategy[][]`	wybrane strategie zawijania.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setWrapStrategy(strategy)`

Ustawia strategię zawijania tekstu w komórkach w zakresie.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametry

Nazwa	Typ	Opis
`strategy`	`WrapStrategy`	Wybrana strategia zawijania.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`setWraps(isWrapEnabled)`

Ustawia prostokątną siatkę zasad zawijania wierszy (musi odpowiadać wymiarom tego zakresu). Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z wyłączonym zawijaniem tekstu wyświetlają jak najwięcej tekstu bez zmiany rozmiaru i przechodzenia do wielu wierszy.

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

// The size of the two-dimensional array must match the size of the range.
const wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parametry

Nazwa	Typ	Opis
`isWrapEnabled`	`Object[][]`	Dwuwymiarowa tablica zmiennych zawijania, która określa, czy zawijać tekst w komórce.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Zobacz też

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Zmienia głębokość grupowania kolumn w zakresie o określoną wartość.

Powoduje to utworzenie, zmodyfikowanie lub usunięcie grup, które przecinają się z zakresem. W przypadku dodatnich wartości delta grupy są tworzone lub modyfikowane, a w przypadku ujemnych wartości delta grupy są usuwane lub modyfikowane.

Nie ma to wpływu na zmniejszanie głębokości grupy poniżej zera ani powyżej ośmiu.

Jeśli wartość column group control position jest mniejsza niż 0, podczas próby przesunięcia głębokości pierwszego wiersza wystąpi błąd.BEFORE

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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`	Wartość, o którą należy zmienić głębokość grupy kolumn w tym zakresie.

Powrót

Range – ten zakres do łączenia.

Rzuty

Error – podczas próby przesunięcia głębi pierwszej kolumny, gdy pozycja sterowania to GroupControlTogglePosition.BEFORE

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`shiftRowGroupDepth(delta)`

Zmienia głębokość grupowania wierszy w zakresie o określoną wartość.

Nie ma to wpływu na zmniejszanie głębokości grupy poniżej zera ani powyżej ośmiu.

Jeśli wartość row group control position to BEFORE, podczas próby przesunięcia głębokości pierwszego wiersza wystąpi błąd.

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

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parametry

Nazwa	Typ	Opis
`delta`	`Integer`	Wartość, o którą należy zmienić głębokość grupy wierszy w tym zakresie.

Powrót

Range – ten zakres do łączenia.

Rzuty

Error – podczas próby przesunięcia głębi pierwszego wiersza, gdy pozycja elementu sterującego to GroupControlTogglePosition.BEFORE

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`sort(sortSpecObj)`

Sortuje komórki w podanym zakresie według określonej kolumny i kolejności.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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 ma być sortowana lista.

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`splitTextToColumns()`

Dzieli kolumnę tekstu na 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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns();

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`splitTextToColumns(delimiter)`

Dzieli kolumnę tekstu na kilka kolumn, używając określonego ciągu znaków jako niestandardowego ogranicznika.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting 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 ma nastąpić podział.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`splitTextToColumns(delimiter)`

Dzieli kolumnę tekstu na kilka kolumn na podstawie określonego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting 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 ma nastąpić podział.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`trimWhitespace()`

Usuwa białe znaki (takie jak spacje, tabulatory lub nowe wiersze) w każdej komórce w tym zakresie. Usuwa wszystkie odstępy na początku i na końcu tekstu w każdej komórce oraz redukuje wszystkie kolejne znaki odstępu do pojedynczej spacji.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`uncheck()`

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

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

Powrót

Range – ten zakres do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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').

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

Logger.log(range.getFontColor());

Powrót

String – kolor czcionki w notacji CSS (np. '#ffffff' lub 'white').

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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').

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

const results = range.getFontColors();

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

Class Range Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Wycofane metody

Szczegółowa dokumentacja

activate()

Powrót

activateAsCurrentCell()

Powrót

Autoryzacja

addDeveloperMetadata(key)

Parametry

Powrót

Autoryzacja

addDeveloperMetadata(key, visibility)

Parametry

Powrót

Autoryzacja

addDeveloperMetadata(key, value)

Parametry

Powrót

Autoryzacja

addDeveloperMetadata(key, value, visibility)

Parametry

Powrót

Autoryzacja

applyColumnBanding()

Powrót

Autoryzacja

applyColumnBanding(bandingTheme)

Parametry

Powrót

Autoryzacja

applyColumnBanding(bandingTheme, showHeader, showFooter)

Parametry

Powrót

Autoryzacja

applyRowBanding()

Powrót

Autoryzacja

applyRowBanding(bandingTheme)

Parametry

Powrót

Autoryzacja

applyRowBanding(bandingTheme, showHeader, showFooter)

Parametry

Powrót

Autoryzacja

autoFill(destination, series)

Parametry

Autoryzacja

autoFillToNeighbor(series)

Parametry

Autoryzacja

breakApart()

Powrót

Autoryzacja

canEdit()

Powrót

Autoryzacja

check()

Powrót

Autoryzacja

clear()

Powrót

Autoryzacja

clear(options)

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

clearContent()

Powrót

Autoryzacja

clearDataValidations()

Powrót

Autoryzacja

clearFormat()

Powrót

Autoryzacja

clearNote()

Class Range

`activate()`

`activateAsCurrentCell()`

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`applyColumnBanding()`

`applyColumnBanding(bandingTheme)`

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

`applyRowBanding()`

`applyRowBanding(bandingTheme)`

`applyRowBanding(bandingTheme, showHeader, showFooter)`

`autoFill(destination, series)`

`autoFillToNeighbor(series)`

`breakApart()`

`canEdit()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`collapseGroups()`

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

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

`copyTo(destination)`

`copyTo(destination, copyPasteType, transposed)`

`copyTo(destination, options)`

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

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

`createDataSourcePivotTable(dataSource)`

`createDataSourceTable(dataSource)`

`createDeveloperMetadataFinder()`

`createFilter()`

`createPivotTable(sourceData)`

`createTextFinder(findText)`

`deleteCells(shiftDimension)`

`expandGroups()`

`getA1Notation()`

`getBackground()`

`getBackgroundObject()`

`getBackgroundObjects()`

`getBackgrounds()`