Class Range

Zakres

Przeglądanie i modyfikowanie zakresów w arkuszach kalkulacyjnych. Zakresem może być pojedyncza komórka w arkuszu lub grupa sąsiadujących komórek w arkuszu.

Metody

MetodaZwracany typKrótki opis
activate()RangeUstawia określony zakres jako active range, gdzie lewa górna komórka w zakresie to current cell.
activateAsCurrentCell()RangeUstawia określoną komórkę jako current cell.
addDeveloperMetadata(key)RangeDodaje do zakresu metadane dewelopera z określonym kluczem.
addDeveloperMetadata(key, visibility)RangeDodaje metadane dewelopera z określonym kluczem i widocznością do zakresu.
addDeveloperMetadata(key, value)RangeDodaje do zakresu metadane dewelopera z określonym kluczem i wartością.
addDeveloperMetadata(key, value, visibility)RangeDodaje do zakresu metadane dewelopera z określonym kluczem, wartością i widocznością.
applyColumnBanding()BandingPowoduje zastosowanie do zakresu domyślnego motywu pasków kolumn.
applyColumnBanding(bandingTheme)BandingStosuje do zakresu określony motyw pasków kolumn.
applyColumnBanding(bandingTheme, showHeader, showFooter)BandingStosuje określony motyw pasków kolumn do zakresu z określonymi ustawieniami nagłówka i stopki.
applyRowBanding()BandingStosuje do zakresu domyślny motyw pasków wierszy.
applyRowBanding(bandingTheme)BandingStosuje do zakresu określony motyw pasków wierszy.
applyRowBanding(bandingTheme, showHeader, showFooter)BandingStosuje określony motyw pasków wierszy do zakresu z określonymi ustawieniami nagłówka i stopki.
autoFill(destination, series)voidWypełnia pole destinationRange danymi na podstawie danych z tego zakresu.
autoFillToNeighbor(series)voidOblicza zakres w celu wypełnienia nowych danych na podstawie sąsiednich komórek i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych zawartych w tym zakresie.
breakApart()RangePodziel wszystkie komórki wielokolumnowe z zakresu na poszczególne komórki.
canEdit()BooleanOkreśla, czy użytkownik ma uprawnienia do edytowania każdej komórki w zakresie.
check()RangeZmienia stan pól wyboru w zakresie na „zaznaczone”.
clear()RangeUsuwa zakres treści i formatów.
clear(options)RangeUsuwa zakres treści, formatu, reguł sprawdzania poprawności danych lub komentarzy zgodnie z określonymi opcjami zaawansowanymi.
clearContent()RangeCzyści zawartość zakresu bez zmian formatowania.
clearDataValidations()RangeCzyści reguły sprawdzania poprawności danych w wybranym zakresie.
clearFormat()RangeUsuwa formatowanie w tym zakresie.
clearNote()RangeCzyści notatkę w danej komórce lub komórce.
collapseGroups()RangeZwija wszystkie grupy, które w całości należą do zakresu.
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidSkopiuj formatowanie zakresu do podanej lokalizacji.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidSkopiuj formatowanie zakresu do podanej lokalizacji.
copyTo(destination)voidKopiowanie danych z zakresu komórek do innego zakresu komórek.
copyTo(destination, copyPasteType, transposed)voidKopiowanie danych z zakresu komórek do innego zakresu komórek.
copyTo(destination, options)voidKopiowanie danych z zakresu komórek do innego zakresu komórek.
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidSkopiuj zawartość zakresu do podanej lokalizacji.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidSkopiuj zawartość zakresu do podanej lokalizacji.
createDataSourcePivotTable(dataSource)DataSourcePivotTableTworzy ze źródła danych pustą tabelę przestawną źródła danych zakotwiczoną w pierwszej komórce w tym zakresie.
createDataSourceTable(dataSource)DataSourceTableTworzy na podstawie źródła danych pustą tabelę źródeł danych zakotwiczoną w pierwszej komórce tego zakresu.
createDeveloperMetadataFinder()DeveloperMetadataFinderZwraca interfejs DeveloperMetadataFinderApi do znajdowania metadanych dewelopera w zakresie tego zakresu.
createFilter()FilterTworzy filtr i stosuje go do określonego zakresu w arkuszu.
createPivotTable(sourceData)PivotTableTworzy pustą tabelę przestawną z określonego zakresu zakotwiczonego sourceData w pierwszej komórce w tym zakresie.
createTextFinder(findText)TextFinderTworzy wyszukiwarkę tekstu dla zakresu, która może znajdować i zastępować tekst w tym zakresie.
deleteCells(shiftDimension)voidUsuwa ten zakres komórek.
expandGroups()RangeRozwija zwinięte grupy, których zakres lub przełącznik sterowania przecina się z tym zakresem.
getA1Notation()StringZwraca opis zakresu w postaci ciągu znaków w notacji A1.
getBackground()StringZwraca kolor tła lewej górnej komórki zakresu (np. '#ffffff').
getBackgroundObject()ColorZwraca kolor tła lewej górnej komórki zakresu.
getBackgroundObjects()Color[][]Zwraca kolory tła komórek w zakresie.
getBackgrounds()String[][]Zwraca kolory tła komórek w zakresie (np. '#ffffff').
getBandings()Banding[]Zwraca wszystkie pasma zastosowane do dowolnych komórek w danym zakresie.
getCell(row, column)RangeZwraca podaną komórkę w zakresie.
getColumn()IntegerZwraca pozycję kolumny początkowej dla tego zakresu.
getDataRegion()RangeZwraca kopię zakresu rozwiniętego w 4 sekcjach Direction, aby uwzględnić wszystkie sąsiednie komórki zawierające dane.
getDataRegion(dimension)RangeZwraca kopię zakresu rozwiniętego Direction.UP i Direction.DOWN, jeśli określony wymiar to Dimension.ROWS, lub Direction.NEXT i Direction.PREVIOUS, jeśli wymiar to Dimension.COLUMNS.
getDataSourceFormula()DataSourceFormulaZwraca DataSourceFormula dla pierwszej komórki w zakresie lub null, jeśli komórka nie zawiera formuły źródła danych.
getDataSourceFormulas()DataSourceFormula[]Zwraca wartości DataSourceFormula dla komórek w zakresie.
getDataSourcePivotTables()DataSourcePivotTable[]Pobiera wszystkie tabele przestawne źródła danych przecinające się z zakresem.
getDataSourceTables()DataSourceTable[]Pobiera wszystkie tabele źródeł danych przecinające się z tym zakresem.
getDataSourceUrl()StringZwraca adres URL danych w tym zakresie, którego można używać do tworzenia wykresów i zapytań.
getDataTable()DataTableZwróć dane wewnątrz tego obiektu w postaci tabeli DataTable.
getDataTable(firstRowIsHeader)DataTableZwraca dane z tego zakresu w postaci tabeli DataTable.
getDataValidation()DataValidationZwraca regułę sprawdzania poprawności danych dla lewej górnej komórki zakresu.
getDataValidations()DataValidation[][]Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
getDeveloperMetadata()DeveloperMetadata[]Pobiera metadane dewelopera powiązane z tym zakresem.
getDisplayValue()StringZwraca wyświetlaną wartość lewej górnej komórki zakresu.
getDisplayValues()String[][]Zwraca prostokątną siatkę wartości z tego zakresu.
getFilter()FilterZwraca filtr w arkuszu, do którego należy dany zakres, lub null, jeśli w arkuszu nie ma filtra.
getFontColorObject()ColorZwraca kolor czcionki komórki w lewym górnym rogu zakresu.
getFontColorObjects()Color[][]Zwraca kolory czcionek w komórkach zakresu.
getFontFamilies()String[][]Zwraca rodziny czcionek w komórkach zakresu.
getFontFamily()StringZwraca rodzinę czcionek w komórce w lewym górnym rogu zakresu.
getFontLine()StringPobiera 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()IntegerZwraca rozmiar czcionki zgodnie z rozmiarem punktu w komórce w lewym górnym rogu zakresu.
getFontSizes()Integer[][]Zwraca rozmiary czcionek w komórkach zakresu.
getFontStyle()StringZwraca styl czcionki ('italic' lub 'normal') komórki w lewym górnym rogu zakresu.
getFontStyles()String[][]Zwraca style czcionek w komórkach zakresu.
getFontWeight()StringZwraca grubość czcionki (normalną/pogrubioną) z komórki w lewym górnym rogu zakresu.
getFontWeights()String[][]Zwraca grubość czcionek komórek w zakresie.
getFormula()StringZwraca formułę (w notacji A1) dla lewej górnej komórki zakresu lub pusty ciąg, jeśli komórka jest pusta lub nie zawiera formuły.
getFormulaR1C1()StringZwraca formułę (notacja R1C1) dla danej komórki lub funkcję null, jeśli jej nie ma.
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()IntegerZwraca identyfikator siatki arkusza nadrzędnego zakresu.
getHeight()IntegerZwraca wysokość zakresu.
getHorizontalAlignment()StringZwraca wyrównanie tekstu w poziomie (do lewej/do środka/do prawej) komórki w lewym górnym rogu zakresu.
getHorizontalAlignments()String[][]Zwraca wyrównanie poziome komórek w zakresie.
getLastColumn()IntegerZwraca pozycję końcowej kolumny.
getLastRow()IntegerZwraca pozycję końcową wiersza.
getMergedRanges()Range[]Zwraca tablicę obiektów Range reprezentujących scalone komórki, które znajdują się w całości w bieżącym zakresie lub zawierają co najmniej jedną komórkę w bieżącym zakresie.
getNextDataCell(direction)RangeZaczyna od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w kierunku, który jest krawędzią sąsiedniego zakresu komórek, w których znajdują się dane, lub komórki znajdującej się na krawędzi arkusza kalkulacyjnego w tym kierunku.
getNote()StringZwraca notatkę powiązaną z podanym zakresem.
getNotes()String[][]Zwraca notatki powiązane z komórkami w zakresie.
getNumColumns()IntegerZwraca liczbę kolumn w tym zakresie.
getNumRows()IntegerZwraca liczbę wierszy w tym zakresie.
getNumberFormat()StringPobierz formatowanie liczby lub daty z lewej górnej komórki zakresu.
getNumberFormats()String[][]Zwraca format liczb lub daty dla komórek w zakresie.
getRichTextValue()RichTextValueZwraca wartość tekstu sformatowanego dla lewej górnej komórki zakresu lub null, jeśli wartość komórki nie jest tekstem.
getRichTextValues()RichTextValue[][]Zwraca wartości z tekstem sformatowanym z komórek w zakresie.
getRow()IntegerZwraca pozycję wiersza z tego zakresu.
getRowIndex()IntegerZwraca pozycję wiersza z tego zakresu.
getSheet()SheetZwraca arkusz, do którego należy ten zakres.
getTextDirection()TextDirectionZwraca kierunek tekstu lewej górnej komórki zakresu.
getTextDirections()TextDirection[][]Zwraca informacje o kierunkach tekstu dla komórek w zakresie.
getTextRotation()TextRotationZwraca ustawienia obrotu tekstu dla lewej górnej komórki zakresu.
getTextRotations()TextRotation[][]Zwraca ustawienia rotacji tekstu dla komórek w zakresie.
getTextStyle()TextStyleZwraca styl tekstu lewej górnej komórki zakresu.
getTextStyles()TextStyle[][]Zwraca style tekstu komórek w zakresie.
getValue()ObjectZwraca wartość lewej górnej komórki zakresu.
getValues()Object[][]Zwraca prostokątną siatkę wartości z tego zakresu.
getVerticalAlignment()StringZwraca wyrównanie w pionie (do góry/do środka/do dołu) komórki w lewym górnym rogu zakresu.
getVerticalAlignments()String[][]Zwraca wyrównania pionowe komórek w zakresie.
getWidth()IntegerZwraca szerokość zakresu w kolumnach.
getWrap()BooleanZwraca, czy tekst w komórce jest zawijany.
getWrapStrategies()WrapStrategy[][]Zwraca strategie zawijania tekstu w komórkach zakresu.
getWrapStrategy()WrapStrategyZwraca strategię zawijania tekstu dla lewej górnej komórki zakresu.
getWraps()Boolean[][]Zwraca, czy tekst w komórkach jest zawijany.
insertCells(shiftDimension)RangeWstawianie do tego zakresu pustych komórek.
insertCheckboxes()RangeWstawianie pól wyboru w każdej komórce zakresu z zaznaczoną opcją true i odznaczoną false.
insertCheckboxes(checkedValue)RangeWstawianie pól wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem w przypadku zaznaczenia.
insertCheckboxes(checkedValue, uncheckedValue)RangeWstawianie pól wyboru do każdej komórki w zakresie ze skonfigurowanymi niestandardowymi wartościami stanu zaznaczonego i odznaczonego.
isBlank()BooleanZwraca wartość true, jeśli zakres jest całkowicie pusty.
isChecked()BooleanZwraca, czy wszystkie komórki w zakresie mają stan pola wyboru „zaznaczone”.
isEndColumnBounded()BooleanOkreśla, czy koniec zakresu jest powiązany z konkretną kolumną.
isEndRowBounded()BooleanOkreśla, czy koniec zakresu jest powiązany z określonym wierszem.
isPartOfMerge()BooleanZwraca wartość true, jeśli komórki w bieżącym zakresie nakładają się na scalone komórki.
isStartColumnBounded()BooleanOkreśla, czy początek zakresu jest powiązany z konkretną kolumną.
isStartRowBounded()BooleanOkreśla, czy początek zakresu jest powiązany z konkretnym wierszem.
merge()RangeScala komórki w zakresie w jeden blok.
mergeAcross()RangeScal komórki z zakresu we wszystkich kolumnach zakresu.
mergeVertically()RangeScala ze sobą komórki w zakresie.
moveTo(target)voidWytnij i wklej (format i wartości) z tego zakresu do zakresu docelowego.
offset(rowOffset, columnOffset)RangeZwraca nowy zakres odsunięty od tego zakresu o podaną liczbę wierszy i kolumn (wartość ujemną).
offset(rowOffset, columnOffset, numRows)RangeZwraca nowy zakres względem bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz podaną wysokość w komórkach.
offset(rowOffset, columnOffset, numRows, numColumns)RangeZwraca nowy zakres względem bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz przy danej wysokości i szerokości komórek.
protect()ProtectionTworzy obiekt, który zabezpiecza zakres przed edycją z wyjątkiem użytkowników z odpowiednimi uprawnieniami.
randomize()RangeLosuje kolejność wierszy w podanym zakresie.
removeCheckboxes()RangeUsuwa wszystkie pola wyboru z zakresu.
removeDuplicates()RangeUsuwa wiersze z tego zakresu, które zawierają wartości będące duplikatami wartości z dowolnego poprzedniego wiersza.
removeDuplicates(columnsToCompare)RangeUsuwa wiersze z tego zakresu, które zawierają wartości w określonych kolumnach, które są duplikatami wartości w dowolnym poprzednim wierszu.
setBackground(color)RangeUstawia kolor tła wszystkich komórek w zakresie w notacji CSS (np. '#ffffff' lub 'white').
setBackgroundObject(color)RangeUstawia kolor tła wszystkich komórek w zakresie.
setBackgroundObjects(color)RangeUstawia prostokątną siatkę z kolorami tła (muszą pasować do wymiarów tego zakresu).
setBackgroundRGB(red, green, blue)RangeUstawia dany kolor tła za pomocą wartości RGB (liczby całkowite od 0 do 255 włącznie).
setBackgrounds(color)RangeUstawia prostokątną siatkę z kolorami tła (muszą pasować do wymiarów tego zakresu).
setBorder(top, left, bottom, right, vertical, horizontal)RangeOkreśla właściwość obramowania.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeOkreśla właściwość obramowania z kolorem i/lub stylem.
setDataValidation(rule)RangeUstawia jedną regułę sprawdzania poprawności danych dla wszystkich komórek w zakresie.
setDataValidations(rules)RangeOkreśla reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
setFontColor(color)RangeUstawia kolor czcionki w notacji CSS (np. '#ffffff' lub 'white').
setFontColorObject(color)RangeUstawia kolor czcionki w podanym zakresie.
setFontColorObjects(colors)RangeUstawia prostokątną siatkę z kolorami czcionek (muszą pasować do wymiarów tego zakresu).
setFontColors(colors)RangeUstawia prostokątną siatkę z kolorami czcionek (muszą pasować do wymiarów tego zakresu).
setFontFamilies(fontFamilies)RangeUstawia prostokątną siatkę rodzin czcionek (muszą pasować do wymiarów tego zakresu).
setFontFamily(fontFamily)RangeUstawia rodzinę czcionek, np. „Yahoo” lub „Helvetica”.
setFontLine(fontLine)RangeUstawia styl linii czcionki w danym zakresie ('underline', 'line-through' lub 'none').
setFontLines(fontLines)RangeUstawia prostokątną siatkę stylów linii (muszą pasować do wymiarów tego zakresu).
setFontSize(size)RangeUstawia rozmiar czcionki, przy czym jest to rozmiar punktu, którego należy użyć.
setFontSizes(sizes)RangeUstawia prostokątną siatkę rozmiarów czcionek (muszą pasować do wymiarów tego zakresu).
setFontStyle(fontStyle)RangeUstaw styl czcionki dla danego zakresu ('italic' lub 'normal').
setFontStyles(fontStyles)RangeUstawia prostokątną siatkę stylów czcionek (muszą pasować do wymiarów tego zakresu).
setFontWeight(fontWeight)RangeUstaw grubość czcionki dla danego zakresu (normalne/pogrubione).
setFontWeights(fontWeights)RangeUstawia prostokątną siatkę grubości czcionek (muszą pasować do wymiarów tego zakresu).
setFormula(formula)RangeAktualizuje formułę dla tego zakresu.
setFormulaR1C1(formula)RangeAktualizuje formułę dla tego zakresu.
setFormulas(formulas)RangeUstawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu).
setFormulasR1C1(formulas)RangeUstawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu).
setHorizontalAlignment(alignment)RangeUmożliwia ustawienie wyrównania w poziomie (od lewej do prawej) w danym zakresie (do lewej/do środka/do prawej).
setHorizontalAlignments(alignments)RangeUstawia prostokątną siatkę z wyrównaniem w poziomie.
setNote(note)RangeUstawia w notatce podaną wartość.
setNotes(notes)RangeUstawia prostokątną siatkę z notatkami (muszą pasować do wymiarów tego zakresu).
setNumberFormat(numberFormat)RangeUstawia format liczby lub daty zgodnie z podanym ciągiem formatowania.
setNumberFormats(numberFormats)RangeUstawia prostokątną siatkę z formatami liczb lub dat (muszą pasować do wymiarów tego zakresu).
setRichTextValue(value)RangeUstawia wartość tekstu sformatowanego dla komórek w zakresie.
setRichTextValues(values)RangeUstawia prostokątną siatkę wartości z tekstem sformatowanym.
setShowHyperlink(showHyperlink)RangeOkreśla, czy w zakresie mają być wyświetlane hiperlinki.
setTextDirection(direction)RangeUstawia kierunek tekstu w komórkach zakresu.
setTextDirections(directions)RangeUstawia prostokątną siatkę z kierunkami tekstu.
setTextRotation(degrees)RangeOkreśla ustawienia rotacji tekstu dla komórek w zakresie.
setTextRotation(rotation)RangeOkreśla ustawienia rotacji tekstu dla komórek w zakresie.
setTextRotations(rotations)RangeUstawia prostokątną siatkę obrotu tekstu.
setTextStyle(style)RangeUstawia styl tekstu w komórkach zakresu.
setTextStyles(styles)RangeUstawia prostokątną siatkę stylów tekstu.
setValue(value)RangeUstawia wartość zakresu.
setValues(values)RangeUstawia prostokątną siatkę wartości (muszą pasować do wymiarów tego zakresu).
setVerticalAlignment(alignment)RangeUstaw wyrównanie w pionie (od góry do dołu) dla danego zakresu (góra, środek, dół).
setVerticalAlignments(alignments)RangeUstawia prostokątną siatkę wyrównań pionowych (muszą pasować do wymiarów tego zakresu).
setVerticalText(isVertical)RangeOkreśla, czy tekst ma być ułożony w komórkach w zakresie.
setWrap(isWrapEnabled)RangeUstawia zawijanie komórki w podanym zakresie.
setWrapStrategies(strategies)RangeUstawia prostokątną siatkę strategii zawijania.
setWrapStrategy(strategy)RangeUstawia strategię zawijania tekstu w komórkach zakresu.
setWraps(isWrapEnabled)RangeUstawia prostokątną siatkę z zasadami zawijania słów (muszą pasować do wymiarów tego zakresu).
shiftColumnGroupDepth(delta)RangeZmienia głębokość grupowania kolumn z zakresu o określoną kwotę.
shiftRowGroupDepth(delta)RangeZmienia głębokość grupowania wierszy z zakresu o określoną kwotę.
sort(sortSpecObj)RangeSortuje komórki w podanym zakresie według kolumny i kolejności.
splitTextToColumns()voidDzieli kolumnę tekstu na kilka kolumn na podstawie automatycznie wykrytego separatora.
splitTextToColumns(delimiter)voidDzieli kolumnę tekstu na kilka kolumn przy użyciu określonego ciągu jako niestandardowego separatora.
splitTextToColumns(delimiter)voidDzieli kolumnę tekstu na kilka kolumn na podstawie określonego separatora.
trimWhitespace()RangePrzycina spacje (np. spacje, tabulatory lub nowe wiersze) we wszystkich komórkach w tym zakresie.
uncheck()RangeZmienia stan pól wyboru w zakresie na „odznaczone”.

Szczegółowa dokumentacja

activate()

Ustawia określony zakres jako active range, gdzie lewa górna komórka w zakresie to current cell.

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

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

Powrót

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


activateAsCurrentCell()

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

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

Jeśli określona komórka nie znajduje się w istniejącym zakresie, istniejący zaznaczony zakres jest usuwany, a komórka staje się komórką bieżącą i aktywnym zakresem.

Uwaga: określony Range musi zawierać jedną komórkę. W przeciwnym razie zgłasza wyjątek.

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

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

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

Powrót

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

Upoważnienie

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

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

addDeveloperMetadata(key)

Dodaje do zakresu metadane dewelopera z określonym kluczem.

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

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

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

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

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

Parametry

NazwaTypOpis
keyStringKlucz do nowych metadanych dewelopera.

Powrót

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

Upoważnienie

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

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

addDeveloperMetadata(key, visibility)

Dodaje metadane dewelopera z określonym kluczem i widocznością do 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 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

NazwaTypOpis
keyStringKlucz do nowych metadanych dewelopera.
visibilityDeveloperMetadataVisibilityWidoczność nowych metadanych dewelopera.

Powrót

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

Upoważnienie

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

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

addDeveloperMetadata(key, value)

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

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

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

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

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

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

Parametry

NazwaTypOpis
keyStringKlucz do nowych metadanych dewelopera.
valueStringWartość nowych metadanych dewelopera.

Powrót

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

Upoważnienie

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

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

addDeveloperMetadata(key, value, visibility)

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

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

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

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

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

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

Parametry

NazwaTypOpis
keyStringKlucz do nowych metadanych dewelopera.
valueStringWartość nowych metadanych dewelopera.
visibilityDeveloperMetadataVisibilityWidoczność nowych metadanych dewelopera.

Powrót

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

Upoważnienie

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

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

applyColumnBanding()

Powoduje zastosowanie do zakresu domyślnego motywu pasków kolumn. Domyślnie pasy zawierają nagłówek i 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 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 pasy.

Upoważnienie

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

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

applyColumnBanding(bandingTheme)

Stosuje do zakresu określony motyw pasków kolumn. Domyślnie pasy zawierają nagłówek i 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 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

NazwaTypOpis
bandingThemeBandingThemeMotyw kolorystyczny do zastosowania do kolumn w zakresie.

Powrót

Banding – nowe pasy.

Upoważnienie

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

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

Stosuje określony motyw pasków kolumn do zakresu z określonymi ustawieniami nagłówka i stopki.

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

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

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

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

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

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

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

Parametry

NazwaTypOpis
bandingThemeBandingThemeMotyw kolorystyczny do zastosowania do kolumn w zakresie.
showHeaderBooleanJeśli true, kolor nagłówka motywu pasków jest stosowany do pierwszej kolumny.
showFooterBooleanJeśli ustawiona jest wartość true, kolor stopki motywu pasków jest stosowany w ostatniej kolumnie.

Powrót

Banding – nowe pasy.

Upoważnienie

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

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

applyRowBanding()

Stosuje do zakresu domyślny motyw pasków wierszy. Domyślnie pasy zawierają nagłówek i nie mają 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 – pasmo.

Upoważnienie

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

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

applyRowBanding(bandingTheme)

Stosuje do zakresu określony motyw pasków wierszy. Domyślnie pasy zawierają nagłówek i nie mają 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

NazwaTypOpis
bandingThemeBandingThememotyw kolorystyczny do zastosowania do wierszy w zakresie,

Powrót

Banding – nowe pasy.

Upoważnienie

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

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

applyRowBanding(bandingTheme, showHeader, showFooter)

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

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

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

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

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

Parametry

NazwaTypOpis
bandingThemeBandingThememotyw kolorystyczny do zastosowania do wierszy w zakresie,
showHeaderBooleanJeśli true, kolor nagłówka motywu pasków jest stosowany w pierwszym wierszu.
showFooterBooleanJeśli true, w ostatnim wierszu zostanie zastosowany kolor stopki motywu pasków.

Powrót

Banding – nowe pasy.

Upoważnienie

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

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

autoFill(destination, series)

Wypełnia pole destinationRange danymi na podstawie danych z tego zakresu. Nowe wartości są też określane przez podany typ series. Zakres docelowy może obejmować ten zakres i rozciągać się tylko w jednym kierunku. Na przykład ten przykład wypełnia pole A1:A20 serią rosnących liczb na podstawie bieżących wartości w tabeli A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

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

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

Parametry

NazwaTypOpis
destinationRangeZakres, który zostanie automatycznie uzupełniony wartościami. Zakres docelowy powinien zawierać ten zakres i rozciągać go tylko w jednym kierunku (w górę, w dół, w lewo lub w prawo).
seriesAutoFillSeriesTyp serii autoFill, której należy używać do obliczania nowych wartości. Efekt tej serii różni się w zależności od typu i ilości danych źródłowych.

Upoważnienie

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

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

autoFillToNeighbor(series)

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

Obliczony zakres docelowy uwzględnia otaczające dane, by określić, gdzie należy wstawić nowe wartości: jeśli z lewej lub prawej strony automatycznie wypełnianej kolumny znajdują się dane, nowe wartości rozciągają się tylko do tych sąsiednich danych.

Jeśli na przykład funkcja A1:A20 jest wypełniona ciągiem rosnących liczb, a ta metoda jest wywoływana w zakresie B1:B4, który zawiera serię dat, nowe wartości są wstawiane tylko do zakresu B5:B20. W ten sposób nowe wartości „przyklejają się” do komórek zawierających wartości z kolumny A.

var sheet = SpreadsheetApp.getActiveSheet();

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

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

Parametry

NazwaTypOpis
seriesAutoFillSeriesTyp serii autoFill, której należy używać do obliczania nowych wartości. Efekt tej serii różni się w zależności od typu i ilości danych źródłowych.

Upoważnienie

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

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

breakApart()

Podziel wszystkie komórki wielokolumnowe z zakresu na poszczególne komórki.

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

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

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

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

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

Powrót

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

Upoważnienie

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

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

canEdit()

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

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

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

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

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

Powrót

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

Upoważnienie

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

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

check()

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

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

Powrót

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

Upoważnienie

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

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

clear()

Usuwa zakres treści i formatów.

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

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

Powrót

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

Upoważnienie

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

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

clear(options)

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

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

Parametry

NazwaTypOpis
optionsObjectObiekt JavaScript określający parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
commentsOnlyBooleanCzy usunąć tylko komentarze.
contentsOnlyBooleanCzy usunąć samą zawartość.
formatOnlyBooleanOkreśla, czy ma zostać wyczyszczony tylko format. Pamiętaj, że wyczyszczenie formatu powoduje również usunięcie reguł sprawdzania poprawności danych.
validationsOnlyBooleanOkreśla, czy wyczyścić tylko reguły sprawdzania poprawności danych.
skipFilteredRowsBooleanOkreśla, czy nie usuwać odfiltrowanych wierszy.

Powrót

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

Upoważnienie

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

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

clearContent()

Czyści zawartość zakresu bez zmian formatowania.

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

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

Powrót

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

Upoważnienie

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

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

clearDataValidations()

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

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

Powrót

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

Upoważnienie

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

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

clearFormat()

Usuwa formatowanie w tym zakresie.

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

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

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

Powrót

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

Upoważnienie

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

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

clearNote()

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

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

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

Powrót

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

Upoważnienie

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

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

collapseGroups()

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

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

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

Powrót

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

Upoważnienie

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

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

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

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

Szczegółowy opis parametru networkId znajdziesz w sekcji getGridId().

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

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

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

Parametry

NazwaTypOpis
gridIdIntegerUnikalny identyfikator arkusza w arkuszu kalkulacyjnym, niezależnie od jego pozycji.
columnIntegerPierwsza kolumna zakresu docelowego.
columnEndIntegerKolumna końcowa zakresu docelowego.
rowIntegerWiersz początkowy zakresu docelowego.
rowEndIntegerWiersz końcowy zakresu docelowego.

Upoważnienie

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

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

Zobacz też


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

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

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

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

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

Parametry

NazwaTypOpis
sheetSheetArkusz docelowy.
columnIntegerPierwsza kolumna zakresu docelowego.
columnEndIntegerKolumna końcowa zakresu docelowego.
rowIntegerWiersz początkowy zakresu docelowego.
rowEndIntegerWiersz końcowy zakresu docelowego.

Upoważnienie

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

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

copyTo(destination)

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

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

Parametry

NazwaTypOpis
destinationRangeZakres docelowy, do którego dane mają być kopiowane. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.

Upoważnienie

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

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

copyTo(destination, copyPasteType, transposed)

Kopiowanie danych z zakresu komórek do innego zakresu komórek.

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

Parametry

NazwaTypOpis
destinationRangeZakres docelowy, do którego dane mają być kopiowane. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.
copyPasteTypeCopyPasteTypeTyp określający sposób wklejania zawartości zakresu do miejsca docelowego.
transposedBooleanOkreśla, czy zakres ma zostać wklejony w orientacji transponowanej.

Upoważnienie

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

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

copyTo(destination, options)

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

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

Parametry

NazwaTypOpis
destinationRangeZakres docelowy, do którego dane mają być kopiowane. Uwzględniona jest tylko pozycja komórki w lewym górnym rogu.
optionsObjectObiekt JavaScript określający parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
formatOnlyBooleanoznacza, że należy skopiować wyłącznie format
contentsOnlyBooleanoznacza, że należy kopiować tylko treść

Upoważnienie

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

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

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

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

Szczegółowy opis parametru networkId znajdziesz w sekcji getGridId().

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

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

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

Parametry

NazwaTypOpis
gridIdIntegerUnikalny identyfikator arkusza w arkuszu kalkulacyjnym, niezależnie od jego pozycji.
columnIntegerPierwsza kolumna zakresu docelowego.
columnEndIntegerKolumna końcowa zakresu docelowego.
rowIntegerWiersz początkowy zakresu docelowego.
rowEndIntegerWiersz końcowy zakresu docelowego.

Upoważnienie

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

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

Zobacz też


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

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

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

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

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

Parametry

NazwaTypOpis
sheetSheetArkusz docelowy.
columnIntegerPierwsza kolumna zakresu docelowego.
columnEndIntegerKolumna końcowa zakresu docelowego.
rowIntegerWiersz początkowy zakresu docelowego.
rowEndIntegerWiersz końcowy zakresu docelowego.

Upoważnienie

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

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

createDataSourcePivotTable(dataSource)

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

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

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

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

Parametry

NazwaTypOpis
dataSourceDataSourceŹródło danych, na podstawie którego ma zostać utworzona tabela przestawna.

Powrót

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

Upoważnienie

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

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

createDataSourceTable(dataSource)

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

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

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

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

Parametry

NazwaTypOpis
dataSourceDataSourceŹródło danych, na podstawie którego ma zostać utworzona tabela przestawna.

Powrót

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

Upoważnienie

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

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

createDeveloperMetadataFinder()

Zwraca interfejs DeveloperMetadataFinderApi do znajdowania metadanych dewelopera w zakresie tego zakresu. Metadane wchodzą w zakres zakresu tylko wtedy, gdy są w całości w nim zawarte. Na przykład metadane powiązane z wierszem „3:3” nie należą do zakresu „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 umożliwiająca wyszukiwanie metadanych z tego zakresu.


createFilter()

Tworzy filtr i stosuje go do określonego zakresu w arkuszu. Nie można utworzyć więcej niż jednego filtra w arkuszu. Aby uzyskać dostęp do filtra i go zmodyfikować po jego utworzeniu, użyj funkcji getFilter() lub Sheet.getFilter().

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

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}
Użyj tej metody, aby utworzyć filtry dla Grid arkuszy (domyślnego typu arkusza). Arkusze siatki to arkusze, które nie są połączone z bazą danych. Aby utworzyć inne typy filtrów, zapoznaj się z tymi informacjami:

Powrót

Filter – nowy filtr.

Upoważnienie

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

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

createPivotTable(sourceData)

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

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

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

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

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

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

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

Parametry

NazwaTypOpis
sourceDataRangeDane, na podstawie których ma zostać utworzona tabela przestawna.

Powrót

PivotTable – nowo utworzony element PivotTable.

Upoważnienie

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

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

createTextFinder(findText)

Tworzy wyszukiwarkę tekstu dla zakresu, która może znajdować i zastępować tekst w tym zakresie.

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

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

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

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

Parametry

NazwaTypOpis
findTextStringTekst do wyszukania.

Powrót

TextFinderTextFinder danego zakresu


deleteCells(shiftDimension)

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

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

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

Parametry

NazwaTypOpis
shiftDimensionDimensionWymiar, w którym mają być przesuwane istniejące dane.

Upoważnienie

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

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

expandGroups()

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

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

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

Powrót

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

Upoważnienie

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

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

getA1Notation()

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

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

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

Powrót

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

Upoważnienie

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

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

getBackground()

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

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

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

Powrót

String – kod koloru tła.

Upoważnienie

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

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

getBackgroundObject()

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

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

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

Powrót

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

Upoważnienie

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

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

getBackgroundObjects()

Zwraca kolory tła komórek w zakresie.

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

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

Powrót

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

Upoważnienie

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

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

getBackgrounds()

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

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

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

Powrót

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

Upoważnienie

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

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

getBandings()

Zwraca wszystkie pasma zastosowane do dowolnych komórek w danym zakresie.

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

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

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

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

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

Powrót

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

Upoważnienie

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

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

getCell(row, column)

Zwraca podaną komórkę w zakresie.

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

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

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

Parametry

NazwaTypOpis
rowIntegerWiersz komórki w odniesieniu do zakresu.
columnIntegerKolumna komórki w odniesieniu do zakresu.

Powrót

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

Upoważnienie

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

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

getColumn()

Zwraca pozycję kolumny początkowej dla tego zakresu.

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

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

Powrót

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

Upoważnienie

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

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

getDataRegion()

Zwraca kopię zakresu rozwiniętego w 4 sekcjach Direction, aby uwzględnić wszystkie sąsiednie komórki zawierające dane. Jeśli zakres jest otoczony pustymi komórkami (z wyłączeniem komórek wzdłuż przekątnych), zwracany jest sam zakres. Przypomina to wybór zakresu i wpisywanie Ctrl+A w edytorze.

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

Powrót

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

Upoważnienie

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

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

getDataRegion(dimension)

Zwraca kopię zakresu rozwiniętego Direction.UP i Direction.DOWN, jeśli określony wymiar to Dimension.ROWS, lub Direction.NEXT i Direction.PREVIOUS, jeśli wymiar to Dimension.COLUMNS. Poszerzenie zakresu odbywa się na podstawie wykrywania danych obok zakresu, który jest uporządkowany jak tabela. Rozszerzony zakres obejmuje wszystkie sąsiednie komórki z danymi w określonym wymiarze, łącznie z granicami tabeli. Jeśli pierwotny zakres jest otoczony pustymi komórkami wzdłuż określonego wymiaru, zwracany jest sam zakres. Ta metoda działa podobnie do wybierania zakresu i wpisywania Ctrl+Space dla kolumn lub Shift+Space dla wierszy w edytorze.

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

Parametry

NazwaTypOpis
dimensionDimensionWymiar, którego wartość ma zostać poszerzona.

Powrót

Range – region danych zakresu lub zakres obejmujący poszczególne kolumny bądź wiersze objęte zakresem pierwotnym.

Upoważnienie

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

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

getDataSourceFormula()

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

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

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

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

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

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

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

Powrót

DataSourceFormulaDataSourceFormula komórki.

Upoważnienie

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

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

getDataSourceFormulas()

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

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

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

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

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

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

Powrót

DataSourceFormula[] – tablica DataSourceFormula.

Upoważnienie

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

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

getDataSourcePivotTables()

Pobiera wszystkie tabele przestawne źródła danych przecinające się z zakresem.

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

Upoważnienie

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

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

getDataSourceTables()

Pobiera wszystkie tabele źródeł danych przecinające się z tym zakresem.

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

Upoważnienie

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

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

getDataSourceUrl()

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

Code.gs

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

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

wykres kołowy.html

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

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

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

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

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

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

Powrót

String – adres URL dla tego zakresu jako źródło danych, który może zostać przekazany do innych interfejsów API, takich jak wykresy.

Upoważnienie

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

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

getDataTable()

Zwróć dane wewnątrz tego obiektu w postaci tabeli 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 formie tabeli danych;


getDataTable(firstRowIsHeader)

Zwraca dane z tego zakresu w postaci tabeli DataTable.

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

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

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

Parametry

NazwaTypOpis
firstRowIsHeaderBooleanOkreśla, czy pierwszy wiersz ma być traktowany jako nagłówek.

Powrót

DataTable – dane w formie tabeli danych.

Upoważnienie

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

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

getDataValidation()

Zwraca regułę sprawdzania poprawności danych dla lewej górnej komórki zakresu. Jeśli w komórce nie skonfigurowano sprawdzania poprawności danych, ta metoda zwraca null.

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

Powrót

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

Upoważnienie

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

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

getDataValidations()

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

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

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

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

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

Powrót

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

Upoważnienie

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

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

getDeveloperMetadata()

Pobiera metadane dewelopera powiązane z tym zakresem.

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

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

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

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

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

Powrót

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

Upoważnienie

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

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

getDisplayValue()

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

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

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

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

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

Powrót

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

Upoważnienie

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

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

getDisplayValues()

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

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

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

Powrót

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

Upoważnienie

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

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

getFilter()

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

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

Powrót

Filter – filtr.

Upoważnienie

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

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

getFontColorObject()

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

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

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

Powrót

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

Upoważnienie

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

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

getFontColorObjects()

Zwraca kolory czcionek w komórkach zakresu.

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

var results = range.getFontColorObjects();

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

Powrót

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

Upoważnienie

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

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

getFontFamilies()

Zwraca rodziny czcionek w komórkach zakresu.

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

var results = range.getFontFamilies();

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

Powrót

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

Upoważnienie

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

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

getFontFamily()

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

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

Logger.log(range.getFontFamily());

Powrót

String – rodzina czcionek w komórce.

Upoważnienie

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

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

getFontLine()

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

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

Logger.log(range.getFontLine());

Powrót

String – linia czcionki.

Upoważnienie

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

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

getFontLines()

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

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

var results = range.getFontLines();

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

Powrót

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

Upoważnienie

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

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

getFontSize()

Zwraca rozmiar czcionki zgodnie z rozmiarem punktu w komórce w lewym górnym rogu zakresu.

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

Logger.log(range.getFontSize());

Powrót

Integer – rozmiar czcionki w punktach.

Upoważnienie

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

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

getFontSizes()

Zwraca rozmiary czcionek w komórkach zakresu.

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

var results = range.getFontSizes();

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

Powrót

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

Upoważnienie

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

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

getFontStyle()

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

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

Logger.log(range.getFontStyle());

Powrót

String – styl czcionki tekstu w komórce.

Upoważnienie

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

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

getFontStyles()

Zwraca style czcionek w komórkach zakresu.

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

var results = range.getFontStyles();

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

Powrót

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

Upoważnienie

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

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

getFontWeight()

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

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

Logger.log(range.getFontWeight());

Powrót

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

Upoważnienie

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

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

getFontWeights()

Zwraca grubość czcionek komórek w zakresie.

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

var results = range.getFontWeights();

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

Powrót

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

Upoważnienie

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

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

getFormula()

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

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

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

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

Powrót

String – formuła komórki.

Upoważnienie

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

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

getFormulaR1C1()

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

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

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

Powrót

String – formuła w notacji R1C1.

Upoważnienie

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

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

getFormulas()

Zwraca formuły (notacja A1) dla komórek w zakresie. Wpisy w tablicy 2D to puste ciągi w komórkach bez formuły.

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

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

Powrót

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

Upoważnienie

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

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

getFormulasR1C1()

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

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

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

Powrót

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

Upoważnienie

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

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

getGridId()

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

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

Logger.log(range.getGridId());

Powrót

Integer – identyfikator siatki arkusza nadrzędnego.

Upoważnienie

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

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

getHeight()

Zwraca wysokość zakresu.

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

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

Powrót

Integer – wysokość zakresu.

Upoważnienie

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

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

getHorizontalAlignment()

Zwraca wyrównanie tekstu w poziomie (do lewej/do środka/do prawej) komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getHorizontalAlignment());

Powrót

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

Upoważnienie

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

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

getHorizontalAlignments()

Zwraca wyrównanie poziome komórek w zakresie.

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

var results = range.getHorizontalAlignments();

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

Powrót

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

Upoważnienie

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

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

getLastColumn()

Zwraca pozycję końcowej kolumny.

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

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

Powrót

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

Upoważnienie

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

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

getLastRow()

Zwraca pozycję końcową wiersza.

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

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

Powrót

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

Upoważnienie

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

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

getMergedRanges()

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

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

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

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

Powrót

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


getNextDataCell(direction)

Zaczyna od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w kierunku, który jest krawędzią sąsiedniego zakresu komórek, w których znajdują się dane, lub komórki znajdującej się na krawędzi arkusza kalkulacyjnego w tym kierunku. To odpowiednik wpisywania Ctrl+[arrow key] w edytorze.

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

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

Parametry

NazwaTypOpis
directionDirectionKierunek, w którym należy znaleźć następną komórkę brzegową regionu danych.

Powrót

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

Upoważnienie

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

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

getNote()

Zwraca notatkę powiązaną z podanym zakresem.

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

Logger.log(range.getNote());

Powrót

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

Upoważnienie

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

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

getNotes()

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

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

var results = range.getNotes();

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

Powrót

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

Upoważnienie

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

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

getNumColumns()

Zwraca liczbę kolumn w tym zakresie.

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

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

Powrót

Integer – liczba kolumn w danym zakresie.

Upoważnienie

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

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

getNumRows()

Zwraca liczbę wierszy w danym zakresie.

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

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

Powrót

Integer – liczba wierszy w danym zakresie.

Upoważnienie

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

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

getNumberFormat()

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

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

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

Powrót

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

Upoważnienie

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

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

getNumberFormats()

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

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

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

Powrót

String[][] – dwuwymiarowa tablica w formatach liczbowych.

Upoważnienie

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

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

getRichTextValue()

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

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

Powrót

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

Upoważnienie

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

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

getRichTextValues()

Zwraca wartości z tekstem sformatowanym z komórek w zakresie.

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

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

Powrót

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

Upoważnienie

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

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

getRow()

Zwraca pozycję wiersza z tego zakresu. Identyczna wartość z metodą getRowIndex().

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

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

Powrót

Integer – pozycja wiersza zakresu.

Upoważnienie

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

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

getRowIndex()

Zwraca pozycję wiersza z tego zakresu. Identyczna wartość z metodą getRow().

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

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

Powrót

Integer – pozycja wiersza zakresu.

Upoważnienie

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

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

Zobacz też


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 dany zakres.

Upoważnienie

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

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

getTextDirection()

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

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

Powrót

TextDirection – kierunek tekstu lewej górnej komórki zakresu.

Upoważnienie

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

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

getTextDirections()

Zwraca informacje o kierunkach tekstu dla komórek w zakresie. Pozycje w tablicy 2D dla komórek z automatycznym wykrywaniem mają wartość null.

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

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

Powrót

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

Upoważnienie

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

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

getTextRotation()

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

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

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

Powrót

TextRotation – ustawienia rotacji tekstu.

Upoważnienie

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

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

getTextRotations()

Zwraca ustawienia rotacji tekstu dla komórek w zakresie.

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

var results = range.getTextRotations();

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

Powrót

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

Upoważnienie

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

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

getTextStyle()

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

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

Powrót

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

Upoważnienie

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

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

getTextStyles()

Zwraca style tekstu komórek w zakresie.

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

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

Powrót

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

Upoważnienie

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

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

getValue()

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

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

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

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

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

Powrót

Object – wartość w danej komórce.

Upoważnienie

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

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

getValues()

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

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

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);
W przypadku aplikacji internetowych wartość Date nie jest dozwolonym parametrem. getValues() nie zwraca danych do aplikacji internetowej, jeśli zakres zawiera komórkę z wartością Date. Zamiast tego przekształć wszystkie wartości pobrane z arkusza na obsługiwane obiekty podstawowe JavaScript, takie jak Number, Boolean lub String.

Powrót

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

Upoważnienie

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

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

getVerticalAlignment()

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

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

Logger.log(range.getVerticalAlignment());

Powrót

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

Upoważnienie

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

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

getVerticalAlignments()

Zwraca wyrównania pionowe komórek w zakresie.

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

var results = range.getVerticalAlignments();

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

Powrót

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

Upoważnienie

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

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

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.

Upoważnienie

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

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

getWrap()

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

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

Logger.log(range.getWrap());

Powrót

Boolean – określa, czy tekst w komórce ma być zawijany.

Upoważnienie

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

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

getWrapStrategies()

Zwraca strategie zawijania tekstu w komórkach zakresu.

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

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

Powrót

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

Upoważnienie

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

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

getWrapStrategy()

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

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

Powrót

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

Upoważnienie

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

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

getWraps()

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

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

var results = range.getVerticalAlignments();

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

Powrót

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

Upoważnienie

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

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

insertCells(shiftDimension)

Wstawianie do tego zakresu pustych komórek. Nowe komórki zachowują formatowanie obecne w komórkach zajmujących ten zakres. Dane istniejące w arkuszu w podanym wymiarze zostaną przeniesione poza wstawiony zakres.

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

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

Parametry

NazwaTypOpis
shiftDimensionDimensionWymiar, w którym mają być przesuwane istniejące dane.

Powrót

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

Upoważnienie

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

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

insertCheckboxes()

Wstawianie pól wyboru w każdej komórce zakresu z zaznaczoną opcją true i odznaczoną false. Ustawia wartość wszystkich komórek w zakresie na false.

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

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

Powrót

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

Upoważnienie

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

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

insertCheckboxes(checkedValue)

Wstawianie pól wyboru do każdej komórki w zakresie z niestandardową wartością zaznaczonego tekstu i pustym ciągiem w przypadku zaznaczenia. Ustawia wartość każdej komórki w zakresie na pusty ciąg.

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

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

Parametry

NazwaTypOpis
checkedValueObjectWartość zaznaczona pola wyboru sprawdzania poprawności danych.

Powrót

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

Upoważnienie

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

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

insertCheckboxes(checkedValue, uncheckedValue)

Wstawianie pól wyboru do każdej komórki w zakresie ze skonfigurowanymi niestandardowymi wartościami stanu zaznaczonego i odznaczonego. Ustawia wartość każdej komórki w zakresie na niestandardową wartość niezaznaczoną.

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

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

Parametry

NazwaTypOpis
checkedValueObjectWartość zaznaczona pola wyboru sprawdzania poprawności danych.
uncheckedValueObjectWartość niezaznaczona pola sprawdzania poprawności danych.

Powrót

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

Upoważnienie

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

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

isBlank()

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

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

Logger.log(range.isBlank());

Powrót

Booleantrue, jeśli zakres jest pusty. W przeciwnym razie false.

Upoważnienie

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

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

isChecked()

Zwraca, czy wszystkie komórki w zakresie mają stan pola wyboru „zaznaczone”. Zwraca wartość null, jeśli niektóre komórki są zaznaczone, a reszta odznaczona lub jeśli w przypadku niektórych komórek nie ma funkcji sprawdzania poprawności danych pól wyboru.

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

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

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

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

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

Powrót

Booleantrue, jeśli zaznaczone są wszystkie komórki w zakresie, false, jeśli wszystkie komórki w zakresie są odznaczone, null, jeśli któreś z komórek są odznaczone lub nie ma włączonego sprawdzania poprawności danych pola wyboru.

Upoważnienie

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

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

isEndColumnBounded()

Określa, czy koniec zakresu jest powiązany z konkretną kolumną. Na przykład w przypadku zakresów A1:B10 lub B:B, które są powiązane z kolumnami na końcu zakresu, 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, 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

Booleantrue, jeśli koniec zakresu jest powiązany z konkretną kolumną. W przeciwnym razie false.

Upoważnienie

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

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

isEndRowBounded()

Określa, czy koniec zakresu jest powiązany z 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, 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

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

Upoważnienie

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

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

isPartOfMerge()

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

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

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

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

Powrót

Booleantrue, jeśli zakres nakłada się na scalone komórki. W przeciwnym razie zwraca false.


isStartColumnBounded()

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

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

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

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

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

Powrót

Booleantrue, jeśli początek zakresu jest powiązany z konkretną kolumną. W przeciwnym razie false.

Upoważnienie

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

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

isStartRowBounded()

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

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

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

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

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

Powrót

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

Upoważnienie

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

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

merge()

Scala komórki w zakresie w jeden blok.

var sheet = SpreadsheetApp.getActiveSheet();

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

Powrót

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

Upoważnienie

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

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

mergeAcross()

Scal komórki z zakresu we wszystkich kolumnach zakresu.

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

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

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

Powrót

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

Upoważnienie

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

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

mergeVertically()

Scala ze sobą komórki w zakresie.

var sheet = SpreadsheetApp.getActiveSheet();

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

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

Powrót

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

Upoważnienie

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

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

moveTo(target)

Wytnij i wklej (format i wartości) z tego zakresu do zakresu docelowego.

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

Parametry

NazwaTypOpis
targetRangeZakres docelowy, do którego ma zostać skopiowany ten zakres. Uwzględniona jest tylko pozycja lewej górnej komórki.

Upoważnienie

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

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

offset(rowOffset, columnOffset)

Zwraca nowy zakres odsunięty od tego zakresu o podaną liczbę wierszy i kolumn (wartość ujemną). Nowy zakres ma taki sam rozmiar jak zakres oryginalny.

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

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

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

Parametry

NazwaTypOpis
rowOffsetIntegerLiczba 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.
columnOffsetIntegerLiczba kolumn na prawo od lewej górnej komórki zakresu. Wartości ujemne oznaczają kolumny na lewo od lewej górnej komórki zakresu.

Powrót

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


offset(rowOffset, columnOffset, numRows)

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

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

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

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

Parametry

NazwaTypOpis
rowOffsetIntegerLiczba 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.
columnOffsetIntegerLiczba kolumn na prawo od lewej górnej komórki zakresu. Wartości ujemne oznaczają kolumny na lewo od lewej górnej komórki zakresu.
numRowsIntegerWysokość w wierszach nowego zakresu.

Powrót

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


offset(rowOffset, columnOffset, numRows, numColumns)

Zwraca nowy zakres względem bieżącego zakresu, którego lewy górny punkt jest odsunięty od bieżącego zakresu o podane wiersze i kolumny oraz przy danej wysokości i szerokości komórek.

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

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

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

Parametry

NazwaTypOpis
rowOffsetIntegerLiczba 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.
columnOffsetIntegerLiczba kolumn na prawo od lewej górnej komórki zakresu. Wartości ujemne oznaczają kolumny na lewo od lewej górnej komórki zakresu.
numRowsIntegerWysokość w wierszach nowego zakresu.
numColumnsIntegerSzerokość w kolumnach nowego zakresu.

Powrót

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


protect()

Tworzy obiekt, który zabezpiecza zakres przed edycją z wyjątkiem użytkowników z odpowiednimi uprawnieniami. Dopóki skrypt nie zmieni listy edytorów zakresu (przez wywołanie Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) lub ustawienie nowej wartości Protection.setDomainEdit(editable)), uprawnienia powielają te z arkusza kalkulacyjnego, co w efekcie oznacza, że zakres pozostaje niechroniony. Jeśli zakres jest już chroniony, ta metoda tworzy nowy zakres chroniony, który nakłada się na istniejący. Jeśli komórka jest chroniona przez wiele chronionych zakresów, z których jeden uniemożliwia pojedynczemu użytkownikowi jej edytowanie, nie może on edytować tej komórki.

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

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

Powrót

Protection – obiekt reprezentujący ustawienia zabezpieczeń.

Upoważnienie

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

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

randomize()

Losuje kolejność wierszy w podanym zakresie.

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

// Randomizes the range
range.randomize();

Powrót

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

Upoważnienie

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

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

removeCheckboxes()

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

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

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

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

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

Powrót

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

Upoważnienie

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

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

removeDuplicates()

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

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

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

Powrót

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

Upoważnienie

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

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

removeDuplicates(columnsToCompare)

Usuwa wiersze z tego zakresu, które zawierają wartości w określonych kolumnach, które są duplikatami wartości w dowolnym poprzednim wierszu. Wiersze z identycznymi wartościami, ale różną wielkością liter, formatowaniem lub formułami są uznawane za duplikaty. Ta metoda usuwa też zduplikowane wiersze, które nie są widoczne (np. z powodu filtra). Treści spoza tego zakresu nie są usuwane.

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

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

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

Parametry

NazwaTypOpis
columnsToCompareInteger[]Kolumny do przeanalizowania pod kątem zduplikowanych wartości. Jeśli nie podasz żadnych kolumn, analizowane będą wszystkie kolumny pod kątem duplikatów.

Powrót

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

Upoważnienie

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

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

setBackground(color)

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

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

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

Parametry

NazwaTypOpis
colorStringKod koloru w notacji CSS (np. '#ffffff' lub 'white'). Wartość null resetuje kolor.

Powrót

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

Upoważnienie

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

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

setBackgroundObject(color)

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

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

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

Parametry

NazwaTypOpis
colorColorKolor tła do ustawienia; wartość null resetuje kolor tła.

Powrót

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

Upoważnienie

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

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

setBackgroundObjects(color)

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

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

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

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

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

Parametry

NazwaTypOpis
colorColor[][]Dwuwymiarowa tablica kolorów. Wartości null resetują kolor.

Powrót

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

Upoważnienie

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

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

setBackgroundRGB(red, green, blue)

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

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

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

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

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

Parametry

NazwaTypOpis
redIntegerWartość czerwonej w notacji RGB.
greenIntegerWartość zielona w notacji RGB.
blueIntegerWartość koloru niebieskiego w notacji RGB.

Powrót

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

Upoważnienie

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

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

setBackgrounds(color)

Ustawia prostokątną siatkę z kolorami tła (muszą pasować do wymiarów tego zakresu). Kolory są określone w notacji CSS (np. '#ffffff' lub 'white').

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

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

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

Parametry

NazwaTypOpis
colorString[][]Dwuwymiarowa tablica kolorów w notacji CSS (np. '#ffffff' lub 'white'). Wartości null resetują kolor.

Powrót

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

Upoważnienie

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

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

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

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

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parametry

NazwaTypOpis
topBooleantrue – obramowanie, false – brak, null – bez zmian.
leftBooleantrue – obramowanie, false – brak, null – bez zmian.
bottomBooleantrue – obramowanie, false – brak, null – bez zmian.
rightBooleantrue – obramowanie, false – brak, null – bez zmian.
verticalBooleantrue – obramowanie pionowe, false – brak, null – bez zmian.
horizontalBooleantrue – obramowanie wewnętrzne, false – brak, null – bez zmian.

Powrót

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

Upoważnienie

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

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

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

Określa właściwość obramowania z kolorem i/lub stylem. Prawidłowe wartości to true (włączony), false (wyłączony) i null (bez zmian). Jako koloru użyj wartości Kolor w notacji CSS (np. '#ffffff' lub 'white').

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

Parametry

NazwaTypOpis
topBooleantrue – obramowanie, false – brak, null – bez zmian.
leftBooleantrue – obramowanie, false – brak, null – bez zmian.
bottomBooleantrue – obramowanie, false – brak, null – bez zmian.
rightBooleantrue – obramowanie, false – brak, null – bez zmian.
verticalBooleantrue – obramowanie pionowe, false – brak, null – bez zmian.
horizontalBooleantrue – obramowanie wewnętrzne, false – brak, null – bez zmian.
colorStringKolor w notacji CSS (np. '#ffffff' lub 'white'), null – kolor domyślny (czarny).
styleBorderStyleStyl obramowania, null – styl domyślny (stały).

Powrót

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

Upoważnienie

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

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

setDataValidation(rule)

Ustawia jedną regułę sprawdzania poprawności danych dla wszystkich komórek w zakresie.

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

Parametry

NazwaTypOpis
ruleDataValidationUstawiona reguła sprawdzania poprawności danych lub null, która usuwa sprawdzanie poprawności danych.

Powrót

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

Upoważnienie

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

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

setDataValidations(rules)

Określa reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie. Metoda ta korzysta z dwuwymiarowej tablicy weryfikacji danych, która jest indeksowana według wiersza, a następnie kolumny. Wymiary tablicy muszą odpowiadać wymiarom zakresu.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parametry

NazwaTypOpis
rulesDataValidation[][]Dwuwymiarowa tablica z regułami sprawdzania poprawności danych do ustawienia. Wartości null usuwają funkcję sprawdzania poprawności danych.

Powrót

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

Upoważnienie

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

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

setFontColor(color)

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

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

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

Parametry

NazwaTypOpis
colorStringKolor czcionki w notacji CSS (np. '#ffffff' lub 'white'). Wartość null resetuje kolor.

Powrót

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

Upoważnienie

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

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

setFontColorObject(color)

Ustawia kolor czcionki w podanym zakresie.

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

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

Parametry

NazwaTypOpis
colorColorUstawiony kolor czcionki; wartość null resetuje kolor.

Powrót

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

Upoważnienie

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

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

setFontColorObjects(colors)

Ustawia prostokątną siatkę z kolorami czcionek (muszą pasować do wymiarów tego zakresu).

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

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

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

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

Parametry

NazwaTypOpis
colorsColor[][]Dwuwymiarowa tablica kolorów; wartości null resetują kolor czcionki.

Powrót

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

Upoważnienie

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

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

setFontColors(colors)

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

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

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

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

Parametry

NazwaTypOpis
colorsObject[][]Dwuwymiarowa tablica kolorów w notacji CSS (np. '#ffffff' lub 'white'). Wartości null resetują kolor.

Powrót

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

Upoważnienie

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

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

setFontFamilies(fontFamilies)

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

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

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Parametry

NazwaTypOpis
fontFamiliesObject[][]Dwuwymiarowa tablica rodzin czcionek; wartości null resetują rodzinę czcionek.

Powrót

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

Upoważnienie

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

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

setFontFamily(fontFamily)

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

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

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

Parametry

NazwaTypOpis
fontFamilyStringRodzina czcionek, która ma zostać ustawiona; wartość null resetuje rodzinę czcionek.

Powrót

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

Upoważnienie

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

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

setFontLine(fontLine)

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

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Parametry

NazwaTypOpis
fontLineStringStyl linii czcionki, 'underline', 'line-through' lub 'none'. Wartość null resetuje styl linii czcionki.

Powrót

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

Upoważnienie

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

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

setFontLines(fontLines)

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

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

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

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Parametry

NazwaTypOpis
fontLinesObject[][]Dwuwymiarowa tablica stylów czcionek ('underline', 'line-through' lub 'none'); wartości null resetują styl linii czcionki.

Powrót

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

Upoważnienie

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

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

setFontSize(size)

Ustawia rozmiar czcionki, przy czym jest to rozmiar punktu, którego należy użyć.

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

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

Parametry

NazwaTypOpis
sizeIntegerRozmiar czcionki w punkcie.

Powrót

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

Upoważnienie

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

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

setFontSizes(sizes)

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

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

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

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Parametry

NazwaTypOpis
sizesObject[][]Dwuwymiarowa tablica rozmiarów.

Powrót

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontStyle(fontStyle)

Ustaw styl czcionki dla danego zakresu ('italic' lub 'normal').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

Parametry

NazwaTypOpis
fontStyleStringStyl czcionki ('italic' lub 'normal'). Wartość null resetuje styl czcionki.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontStyles(fontStyles)

Ustawia prostokątną siatkę stylów czcionek (muszą pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parametry

NazwaTypOpis
fontStylesObject[][]Dwuwymiarowa tablica stylów czcionek, 'italic' lub 'normal'; wartości null resetują styl czcionki.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontWeight(fontWeight)

Ustaw grubość czcionki dla danego zakresu (normalne/pogrubione).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Parametry

NazwaTypOpis
fontWeightStringGrubość czcionki ('bold' lub 'normal'). Wartość null resetuje grubość czcionki.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontWeights(fontWeights)

Ustawia prostokątną siatkę grubości czcionek (muszą pasować do wymiarów tego zakresu). Przykładem grubości czcionki jest „pogrubienie”.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Parametry

NazwaTypOpis
fontWeightsObject[][]Dwuwymiarowa tablica grubości czcionek 'bold' lub 'normal'. Wartości null resetują grubość czcionki.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormula(formula)

Aktualizuje formułę dla tego zakresu. Podana formuła musi być w notacji A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

Parametry

NazwaTypOpis
formulaStringCiąg reprezentujący formułę do ustawienia w komórce.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormulaR1C1(formula)

Aktualizuje formułę dla tego zakresu. Podana formuła musi być w notacji R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

Parametry

NazwaTypOpis
formulaStringFormuła ciągu znaków.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormulas(formulas)

Ustawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu). Podane formuły muszą być w notacji A1. Ta metoda korzysta z dwuwymiarowej tablicy formuł indeksowanych według wiersza, a następnie kolumny. Wymiary tablicy muszą odpowiadać wymiarom zakresu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Parametry

NazwaTypOpis
formulasString[][]Dwuwymiarowa tablica ciągów z formułami.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormulasR1C1(formulas)

Ustawia prostokątną siatkę formuł (muszą pasować do wymiarów tego zakresu). Podane formuły muszą być w notacji R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parametry

NazwaTypOpis
formulasString[][]Dwuwymiarowa tablica formuł w formacie R1C1.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHorizontalAlignment(alignment)

Umożliwia ustawienie wyrównania w poziomie (od lewej do prawej) w danym zakresie (do lewej/do środka/do prawej).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Parametry

NazwaTypOpis
alignmentStringWyrównanie ('left', 'center' lub 'normal'). Wartość null powoduje zresetowanie wyrównania.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHorizontalAlignments(alignments)

Ustawia prostokątną siatkę wyrównań w poziomie. Patrz setHorizontalAlignment(alignment)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Parametry

NazwaTypOpis
alignmentsObject[][]Dwuwymiarowa tablica wyrównań 'left', 'center' lub 'normal'. Wartość null resetuje wyrównanie.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Zobacz też


setNote(note)

Ustawia w notatce podaną wartość.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

Parametry

NazwaTypOpis
noteStringWartość notatki do ustawienia zakresu. Wartość null powoduje usunięcie notatki.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setNotes(notes)

Ustawia prostokątną siatkę z notatkami (muszą pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Parametry

NazwaTypOpis
notesObject[][]Dwuwymiarowa tablica notatek. Wartości null usuwają notatkę.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Zobacz też


setNumberFormat(numberFormat)

Ustawia format liczby lub daty zgodnie z podanym ciągiem formatowania. Akceptowane wzorce formatów są opisane w dokumentacji interfejsu Sheets API.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

Parametry

NazwaTypOpis
numberFormatStringCiąg w formacie liczbowym.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setNumberFormats(numberFormats)

Ustawia prostokątną siatkę z formatami liczb lub dat (muszą pasować do wymiarów tego zakresu). Wartości są ciągami wzorców formatów zgodnie z opisem w dokumentacji interfejsu Sheets API.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

Parametry

NazwaTypOpis
numberFormatsObject[][]Dwuwymiarowa tablica formatów liczb.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRichTextValue(value)

Ustawia wartość tekstu sformatowanego dla komórek w zakresie.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Parametry

NazwaTypOpis
valueRichTextValueWymagana wartość tekstu sformatowanego.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRichTextValues(values)

Ustawia prostokątną siatkę wartości z tekstem sformatowanym.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parametry

NazwaTypOpis
valuesRichTextValue[][]Wymagane wartości tekstu sformatowanego.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Określa, czy w zakresie mają być wyświetlane 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

NazwaTypOpis
showHyperlinkBooleanOkreśla, czy hiperlink ma być wyświetlany.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextDirection(direction)

Ustawia kierunek tekstu w komórkach zakresu. Jeśli określony kierunek to null, zostanie on wywnioskowany, a następnie ustawiony.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametry

NazwaTypOpis
directionTextDirectionWybrany kierunek tekstu. Jeśli wybierzesz null, kierunek jest ustalany przed ustawieniem.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextDirections(directions)

Ustawia prostokątną siatkę z kierunkami tekstu. Jeśli określony kierunek to null, zostanie on wywnioskowany i ustalony.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Parametry

NazwaTypOpis
directionsTextDirection[][]Żądane kierunki tekstu. Jeśli określony kierunek to null, zostanie on wywnioskowany przed ustawieniem.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextRotation(degrees)

Określa ustawienia rotacji tekstu dla komórek w zakresie. Wartość wejściowa odpowiada kątowi między standardową orientacją tekstu a żądaną orientacją. Wartość 0 oznacza, że tekst ma orientację standardową.

W przypadku kierunku tekstu od lewej do prawej kąty dodatnie są wykonywane w lewo, a od prawej do lewej – w prawo.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Parametry

NazwaTypOpis
degreesIntegerWybrany kąt między orientacją standardową a żądaną. W przypadku tekstu od lewej do prawej kąty dodatnie są wykonywane w kierunku przeciwnym do ruchu wskazówek zegara.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextRotation(rotation)

Określa ustawienia rotacji tekstu dla komórek w zakresie.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Parametry

NazwaTypOpis
rotationTextRotationWybrane ustawienia rotacji tekstu.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextRotations(rotations)

Ustawia prostokątną siatkę obrotu tekstu.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Parametry

NazwaTypOpis
rotationsTextRotation[][]Wybrane ustawienia rotacji tekstu.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextStyle(style)

Ustawia styl tekstu w komórkach zakresu.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Parametry

NazwaTypOpis
styleTextStyleŻądany styl tekstu.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextStyles(styles)

Ustawia prostokątną siatkę stylów tekstu.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

Parametry

NazwaTypOpis
stylesTextStyle[][]Wybrane style tekstu.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setValue(value)

Ustawia wartość zakresu. Może to być liczba, ciąg znaków, wartość logiczna lub data. Jeśli zaczyna się od '=', jest interpretowany jako formuła.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

Parametry

NazwaTypOpis
valueObjectWartość zakresu.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setValues(values)

Ustawia prostokątną siatkę wartości (muszą pasować do wymiarów tego zakresu). Jeśli wartość zaczyna się od =, jest interpretowana jako formuła.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

Parametry

NazwaTypOpis
valuesObject[][]Dwuwymiarowa tablica wartości.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVerticalAlignment(alignment)

Ustaw wyrównanie w pionie (od góry do dołu) dla danego zakresu (góra, środek, dół).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Parametry

NazwaTypOpis
alignmentStringWyrównanie ('top', 'middle' lub 'bottom'). Wartość null powoduje zresetowanie wyrównania.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVerticalAlignments(alignments)

Ustawia prostokątną siatkę wyrównań pionowych (muszą pasować do wymiarów tego zakresu).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Parametry

NazwaTypOpis
alignmentsObject[][]Dwuwymiarowa tablica wyrównań 'top', 'middle' lub 'bottom'. Wartość null resetuje wyrównanie.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Zobacz też


setVerticalText(isVertical)

Określa, czy tekst ma być ułożony w komórkach w zakresie. Jeśli tekst zostanie ułożony w pionie, ustawienie obrotu tekstu jest ignorowane.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Parametry

NazwaTypOpis
isVerticalBooleanOkreśla, czy tekst ma być ułożony w stos.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWrap(isWrapEnabled)

Ustawia zawijanie komórki w podanym zakresie.

Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, aby wyświetlić całą ich zawartość. Komórki z wyłączonym zawijaniem wyświetlają się w jak największym stopniu w komórce bez zmiany rozmiaru lub przejścia do wielu wierszy.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

Parametry

NazwaTypOpis
isWrapEnabledBooleanOkreśla, czy tekst ma zawijać czy nie.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWrapStrategies(strategies)

Ustawia prostokątną siatkę strategii zawijania.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Parametry

NazwaTypOpis
strategiesWrapStrategy[][]Pożądane strategie pakowania.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWrapStrategy(strategy)

Ustawia strategię zawijania tekstu w komórkach zakresu.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametry

NazwaTypOpis
strategyWrapStrategyDocelowa strategia pakowania.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWraps(isWrapEnabled)

Ustawia prostokątną siatkę z zasadami zawijania słów (muszą pasować do wymiarów tego zakresu). Komórki z włączonym zawijaniem (domyślnie) zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z wyłączonym zawijaniem wyświetlają się w jak największym stopniu bez zmiany rozmiaru lub przejścia do wielu wierszy.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Parametry

NazwaTypOpis
isWrapEnabledObject[][]Dwuwymiarowa tablica zmiennych zawijania, które określają, czy tekst ma być zawijany w komórce.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Zobacz też


shiftColumnGroupDepth(delta)

Zmienia głębokość grupowania kolumn z zakresu o określoną kwotę.

W efekcie tworzone, modyfikowane i usuwane grupy przecinają się z zakresem. W przypadku delt dodatnich grupy są tworzone lub modyfikowane, a w przypadku delt ujemnych grupy są niszczone lub modyfikowane.

Nie ma to wpływu na głębokość grupy poniżej zera lub powyżej 8.

Jeśli column group control position to BEFORE, podczas próby przesunięcia głębokości pierwszego wiersza zwracany jest błąd.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parametry

NazwaTypOpis
deltaIntegerKwota, o którą ma zostać zmieniona głębokość grupy kolumn w tym zakresie.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Wyrzuca

Error – podczas próby przesunięcia głębokości pierwszej kolumny, gdy pozycja kontrolna wynosi GroupControlTogglePosition.BEFORE

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

shiftRowGroupDepth(delta)

Zmienia głębokość grupowania wierszy z zakresu o określoną kwotę.

W efekcie tworzone, modyfikowane i usuwane grupy przecinają się z zakresem. W przypadku delt dodatnich grupy są tworzone lub modyfikowane, a w przypadku delt ujemnych grupy są niszczone lub modyfikowane.

Nie ma to wpływu na głębokość grupy poniżej zera lub powyżej 8.

Jeśli row group control position to BEFORE, podczas próby przesunięcia głębokości pierwszego wiersza zwracany jest błąd.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parametry

NazwaTypOpis
deltaIntegerKwota, o którą ma zostać zmieniona głębokość grupy wierszy w tym zakresie.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Wyrzuca

Error – podczas próby przesunięcia głębokości pierwszego wiersza, gdy pozycja kontrolna wynosi GroupControlTogglePosition.BEFORE

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sort(sortSpecObj)

Sortuje komórki w podanym zakresie według kolumny i kolejności.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

Parametry

NazwaTypOpis
sortSpecObjObjectKolumny, według których należy sortować dane.

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

splitTextToColumns()

Dzieli kolumnę tekstu na kilka kolumn na podstawie automatycznie wykrytego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

splitTextToColumns(delimiter)

Dzieli kolumnę tekstu na kilka kolumn przy użyciu określonego ciągu jako niestandardowego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametry

NazwaTypOpis
delimiterStringNiestandardowy separator, według którego chcesz dokonać podziału.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

splitTextToColumns(delimiter)

Dzieli kolumnę tekstu na kilka kolumn na podstawie określonego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametry

NazwaTypOpis
delimiterTextToColumnsDelimiterGotowy separator, według którego chcesz dokonać podziału.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

trimWhitespace()

Przycina spacje (np. spacje, tabulatory lub nowe wiersze) we wszystkich komórkach w tym zakresie. Usuwa wszystkie odstępy z początku i końca tekstu w każdej komórce oraz zmniejsza kolejną sekwencję pozostałych znaków odstępu do jednej spacji.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

uncheck()

Zmienia stan pól wyboru w zakresie na „odznaczone”. Ignoruje komórki w zakresie, które obecnie nie zawierają skonfigurowanych wartości zaznaczonych ani odznaczonych.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Powrót

Range – ten zakres na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Wycofane metody