Class Range

Zakres

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

Metody

MetodaZwracany typKrótki opis
activate()RangeUstawia określony zakres jako active range, a komórkę w lewym górnym rogu zakresu jako current cell.
activateAsCurrentCell()RangeUstawia wskazaną komórkę jako current cell.
addDeveloperMetadata(key)RangeDodaje metadane dewelopera z określonym kluczem do zakresu.
addDeveloperMetadata(key, visibility)RangeDodaje metadanych 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 metadanych dewelopera z określonym kluczem, wartością i widocznością do zakresu.
applyColumnBanding()BandingStosuje domyślny motyw pasków kolumn do zakresu.
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()BandingDo zakresu zostanie zastosowany 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 element destinationRange danymi na podstawie danych z tego zakresu.
autoFillToNeighbor(series)voidOblicza zakres, który ma wypełnić nowymi danymi na podstawie sąsiednich komórek, i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych zawartych w tym zakresie.
breakApart()RangePonownie podziel wszystkie komórki wielokolumnowe w zakresie na pojedyncze komórki.
canEdit()BooleanOkreśla, czy użytkownik ma uprawnienia do edytowania każdej komórki w zakresie.
check()RangeStan pól wyboru w zakresie zmieni się na „zaznaczone”.
clear()RangeWyczyść zakres treści i formatów.
clear(options)RangeCzyści zakres treści, format, reguły sprawdzania poprawności danych lub komentarze zgodnie z danymi opcjami zaawansowanymi.
clearContent()RangeCzyści zawartość zakresu, pozostawiając formatowanie.
clearDataValidations()RangeCzyści reguły sprawdzania poprawności danych w zakresie.
clearFormat()RangeUsuwa formatowanie z tego zakresu.
clearNote()RangeUsuwa notatkę z danej komórki lub komórek.
collapseGroups()RangeZwija wszystkie grupy, które mieszczą się całkowicie w zakresie.
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)voidSkopiuj dane z zakresu komórek do innego zakresu komórek.
copyTo(destination, copyPasteType, transposed)voidSkopiuj dane z zakresu komórek do innego zakresu komórek.
copyTo(destination, options)voidSkopiuj dane 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 pustą tabelę przestawną źródła danych na podstawie tego źródła danych, przypięta do pierwszej komórki w tym zakresie.
createDataSourceTable(dataSource)DataSourceTableTworzy pustą tabelę źródła danych na podstawie źródła danych, zadokowaną w pierwszej komórce tego zakresu.
createDeveloperMetadataFinder()DeveloperMetadataFinderZwraca interfejs API „DeveloperMetadataFinderApi” służący 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ą na podstawie określonego zakresu sourceData, który jest zakotwiczony w pierwszej komórce tego zakresu.
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ętych grup, których zakres lub przełącznik kontrolny przecina się z tym zakresem.
getA1Notation()StringZwraca ciąg tekstowy opisujący zakres w notacji A1.
getBackground()StringZwraca kolor tła lewej górnej komórki w zakresie (np. '#ffffff').
getBackgroundObject()ColorZwraca kolor tła lewej górnej komórki w zakresie.
getBackgroundObjects()Color[][]Zwraca kolory tła komórek w zakresie.
getBackgrounds()String[][]Zwraca kolory tła komórek w zakresie (na przykład '#ffffff').
getBandings()Banding[]Zwraca wszystkie pasma, które są stosowane do komórek w tym zakresie.
getCell(row, column)RangeZwraca podawaną komórkę w zakresie.
getColumn()IntegerZwraca pozycję początkową kolumny w przypadku tego zakresu.
getDataRegion()RangeZwraca kopię zakresu rozwiniętego w 4 kierunkach Direction, aby objąć wszystkie sąsiednie komórki z danymi.
getDataRegion(dimension)RangeZwraca kopię zakresu rozwiniętego Direction.UP i Direction.DOWN, jeśli podany wymiar to Dimension.ROWS, lub Direction.NEXT i Direction.PREVIOUS, jeśli wymiar to Dimension.COLUMNS.
getDataSourceFormula()DataSourceFormulaZwraca wartość DataSourceFormula dla pierwszej komórki w zakresie lub null, jeśli komórka nie zawiera formuły źródła danych.
getDataSourceFormulas()DataSourceFormula[]Zwraca DataSourceFormula komórek w zakresie.
getDataSourcePivotTables()DataSourcePivotTable[]Pobiera wszystkie tabele przestawne źródeł danych, które pokrywają się z zakresem.
getDataSourceTables()DataSourceTable[]Pobiera wszystkie tabele źródeł danych, które pokrywają się z zakresem.
getDataSourceUrl()StringZwraca adres URL danych z tego zakresu, który można wykorzystać do tworzenia wykresów i zapytań.
getDataTable()DataTableZwraca dane z tego obiektu jako DataTable.
getDataTable(firstRowIsHeader)DataTableZwraca dane z tego zakresu jako DataTable.
getDataValidation()DataValidationZwraca regułę sprawdzania poprawności danych dla komórki w lewym górnym rogu zakresu.
getDataValidations()DataValidation[][]Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
getDeveloperMetadata()DeveloperMetadata[]Pobiera metadane dewelopera powiązane z tym zakresem.
getDisplayValue()StringZwraca wyświetlaną wartość komórki w lewym górnym rogu zakresu.
getDisplayValues()String[][]Zwraca prostokątną siatkę wartości dla tego zakresu.
getFilter()FilterZwraca filtr w arkuszu, do którego należy ten zakres, lub wartość 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 komórek w zakresie.
getFontFamilies()String[][]Zwraca rodziny czcionek komórek w zakresie.
getFontFamily()StringZwraca rodzinę czcionek komórki 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 w punktach komórki w lewym górnym rogu zakresu.
getFontSizes()Integer[][]Zwraca rozmiary czcionek komórek w zakresie.
getFontStyle()StringZwraca styl czcionki ('italic' lub 'normal') komórki w lewym górnym rogu zakresu.
getFontStyles()String[][]Zwraca style czcionek komórek w zakresie.
getFontWeight()StringZwraca wagę czcionki (normalna/pogrubiona) komórki w lewym górnym rogu zakresu.
getFontWeights()String[][]Zwraca wagi czcionek komórek w zakresie.
getFormula()StringZwraca formułę (notacja A1) komórki lewej górnej zakresu lub pusty ciąg znaków, jeśli komórka jest pusta lub nie zawiera formuły.
getFormulaR1C1()StringZwraca formułę (notacja R1C1) dla danej komórki lub null, jeśli jej nie ma.
getFormulas()String[][]Zwraca formuły (notacja A1) komórek w zakresie.
getFormulasR1C1()String[][]Zwraca formuły (notacja R1C1) komórek w zakresie.
getGridId()IntegerZwraca identyfikator siatki arkusza nadrzędnego zakresu.
getHeight()IntegerZwraca wysokość zakresu.
getHorizontalAlignment()StringZwraca wyrównanie poziome tekstu (lewo/środku/prawo) komórki w lewym górnym rogu zakresu.
getHorizontalAlignments()String[][]Zwraca wyrównanie poziome komórek w zakresie.
getLastColumn()IntegerZwraca pozycję kolumny końcowej.
getLastRow()IntegerZwraca pozycję końcowego 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)RangeZaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w danym kierunku, która jest krawędzią ciągłego zakresu komórek z danymi lub komórką na krawędzi arkusza w tym kierunku.
getNote()StringZwraca notatkę powiązaną z danym 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()StringPobiera format liczby lub daty komórki w lewym górnym rogu danego zakresu.
getNumberFormats()String[][]Zwraca formaty liczb lub dat dla komórek w zakresie.
getRichTextValue()RichTextValueZwraca wartość sformatowanego tekstu w lewej górnej komórce zakresu lub null, jeśli wartość komórki nie jest tekstem.
getRichTextValues()RichTextValue[][]Zwraca wartości sformatowanego tekstu w komórkach w zakresie.
getRow()IntegerZwraca pozycję wiersza w przypadku tego zakresu.
getRowIndex()IntegerZwraca pozycję wiersza w przypadku tego zakresu.
getSheet()SheetZwraca arkusz, do którego należy ten zakres.
getTextDirection()TextDirectionZwraca kierunek tekstu w lewym górnym rogu komórki zakresu.
getTextDirections()TextDirection[][]Zwraca tekstowe kierunki dla komórek w zakresie.
getTextRotation()TextRotationZwraca ustawienia obracania tekstu w lewej górnej komórce zakresu.
getTextRotations()TextRotation[][]Zwraca ustawienia obracania tekstu w komórkach w zakresie.
getTextStyle()TextStyleZwraca styl tekstu w lewym górnym rogu komórki zakresu.
getTextStyles()TextStyle[][]Zwraca style tekstu w komórkach w zakresie.
getValue()ObjectZwraca wartość komórki lewej górnej części zakresu.
getValues()Object[][]Zwraca prostokątną siatkę wartości dla tego zakresu.
getVerticalAlignment()StringZwraca wyrównanie pionowe (góra/środek/dół) komórki w lewym górnym rogu zakresu.
getVerticalAlignments()String[][]Zwraca wyrównanie pionowe komórek w zakresie.
getWidth()IntegerZwraca szerokość zakresu w kolumnach.
getWrap()BooleanZwraca, czy tekst w komórce jest zawijany.
getWrapStrategies()WrapStrategy[][]Zwraca strategie przenoszenia tekstu w komórkach w zakresie.
getWrapStrategy()WrapStrategyZwraca strategię przenoszenia tekstu w lewej górnej komórce zakresu.
getWraps()Boolean[][]Zwraca, czy tekst w komórkach jest zawijany.
insertCells(shiftDimension)RangeWstawia puste komórki w tym zakresie.
insertCheckboxes()RangeWstawia pola wyboru w każdej komórce w zakresie, skonfigurowane za pomocą true dla zaznaczonych i false dla niezaznaczonych.
insertCheckboxes(checkedValue)RangeWstawia pola wyboru do każdej komórki w zakresie, skonfigurowane z niestandardową wartością dla zaznaczonego pola i pustym ciągiem znaków dla niezaznaczonego pola.
insertCheckboxes(checkedValue, uncheckedValue)RangeWstawia pola wyboru w każdej komórce zakresu, skonfigurowane z niestandardowymi wartościami dla zaznaczonych i niezaznaczonych stanów.
isBlank()BooleanZwraca true, jeśli zakres jest całkowicie pusty.
isChecked()BooleanZwraca wartość wskazującą, czy stan pola wyboru we wszystkich komórkach w zakresie to „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 określonym wierszem.
merge()RangeŁączy komórki w zakresie w jeden blok.
mergeAcross()Rangescalić komórki w zakresie w kolumnach zakresu;
mergeVertically()RangeScal komórki w zakresie.
moveTo(target)voidWytnij i wklej (format i wartości) z tego zakresu do docelowego zakresu.
offset(rowOffset, columnOffset)RangeZwraca nowy zakres przesunięty względem tego zakresu o określoną liczbę wierszy i kolumn (która może być ujemna).
offset(rowOffset, columnOffset, numRows)RangeZwraca nowy zakres, który jest względny względem bieżącego zakresu, a jego lewy górny róg jest przesunięty względem bieżącego zakresu o podaną liczbę wierszy i kolumn oraz ma podaną wysokość w komórkach.
offset(rowOffset, columnOffset, numRows, numColumns)RangeZwraca nowy zakres, który jest względny względem bieżącego zakresu, którego lewy górny punkt jest przesunięty względem bieżącego zakresu o podaną liczbę wierszy i kolumn, a wysokość i szerokość są podane w komórkach.
protect()ProtectionTworzy obiekt, który może chronić zakres przed edytowaniem przez użytkowników, którzy nie mają uprawnień.
randomize()RangeLosowo zmienia kolejność wierszy w danym zakresie.
removeCheckboxes()Rangeusuwa wszystkie pola wyboru z zakresu.
removeDuplicates()RangeUsuń wiersze w tym zakresie, które zawierają wartości będące duplikatami wartości w dowolnym poprzednim wierszu.
removeDuplicates(columnsToCompare)RangeUsuwa wiersze w tym zakresie, które zawierają w określonych kolumnach wartości będące duplikatami wartości z dowolnego poprzedniego wiersza.
setBackground(color)RangeUstawia kolor tła wszystkich komórek w zakresie za pomocą notacji CSS (np. '#ffffff'lub 'white').
setBackgroundObject(color)RangeUstawia kolor tła wszystkich komórek w zakresie.
setBackgroundObjects(color)RangeUstawia prostokątną siatkę kolorów tła (musi odpowiadać wymiarom tego zakresu).
setBackgroundRGB(red, green, blue)RangeUstawia tło na dany kolor za pomocą wartości RGB (liczb całkowitych z zakresu od 0 do 255 włącznie).
setBackgrounds(color)RangeUstawia prostokątną siatkę kolorów tła (musi odpowiadać wymiarom tego zakresu).
setBorder(top, left, bottom, right, vertical, horizontal)RangeUstawia właściwość obramowania.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeUstawia właściwość obramowania, określając kolor lub styl.
setDataValidation(rule)RangeUstawia jedną regułę sprawdzania poprawności danych dla wszystkich komórek w zakresie.
setDataValidations(rules)RangeUstawia reguły sprawdzania poprawności danych we wszystkich komórkach w zakresie.
setFontColor(color)RangeUstawia kolor czcionki w notacji CSS (np. '#ffffff' lub 'white').
setFontColorObject(color)RangeUstawia kolor czcionki w danym zakresie.
setFontColorObjects(colors)RangeUstawia prostokątną siatkę kolorów czcionek (musi odpowiadać wymiarom tego zakresu).
setFontColors(colors)RangeUstawia prostokątną siatkę kolorów czcionek (musi odpowiadać wymiarom tego zakresu).
setFontFamilies(fontFamilies)RangeUstawia prostokątną siatkę rodzin czcionek (musi odpowiadać wymiarom tego zakresu).
setFontFamily(fontFamily)RangeUstawia rodzinę czcionek, np. „Arial” 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 (musi być zgodna z wymiarami tego zakresu).
setFontSize(size)RangeUstawia rozmiar czcionki, który jest rozmiarem punktu.
setFontSizes(sizes)RangeUstawia prostokątną siatkę rozmiarów czcionek (musi odpowiadać wymiarom tego zakresu).
setFontStyle(fontStyle)RangeUstaw styl czcionki dla danego zakresu ('italic' lub 'normal').
setFontStyles(fontStyles)RangeUstawia prostokątną siatkę stylów czcionek (musi odpowiadać wymiarom tego zakresu).
setFontWeight(fontWeight)RangeUstaw grubość czcionki w danym zakresie (normalna/pogrubiona).
setFontWeights(fontWeights)RangeUstawia prostokątną siatkę grubości czcionki (musi odpowiadać wymiarom tego zakresu).
setFormula(formula)RangeZaktualizuje formułę dla tego zakresu.
setFormulaR1C1(formula)RangeZaktualizuje formułę dla tego zakresu.
setFormulas(formulas)RangeUstawia prostokątną siatkę formuł (musi odpowiadać wymiarom tego zakresu).
setFormulasR1C1(formulas)RangeUstawia prostokątną siatkę formuł (musi odpowiadać wymiarom tego zakresu).
setHorizontalAlignment(alignment)RangeUstaw wyrównanie poziome (od lewej do prawej) dla danego zakresu (lewo/środku/prawo).
setHorizontalAlignments(alignments)RangeUstawia prostokątną siatkę wyrównania poziomego.
setNote(note)RangeUstawia notatkę na podaną wartość.
setNotes(notes)RangeUstawia prostokątną siatkę notatek (musi odpowiadać wymiarom tego zakresu).
setNumberFormat(numberFormat)RangeUstawia format liczby lub daty na podany ciąg znaków formatowania.
setNumberFormats(numberFormats)RangeUstawia prostokątną siatkę formatów liczb lub dat (musi być zgodna z wymiarami tego zakresu).
setRichTextValue(value)RangeUstawia wartość sformatowanego tekstu w komórkach w zakresie.
setRichTextValues(values)RangeUstawia prostokątną siatkę wartości sformatowanego tekstu.
setShowHyperlink(showHyperlink)RangeOkreśla, czy zakres ma zawierać hiperlinki.
setTextDirection(direction)RangeUstawia kierunek tekstu w komórkach w zakresie.
setTextDirections(directions)RangeUstawia prostokątną siatkę wskazówek tekstowych.
setTextRotation(degrees)RangeUstawia ustawienia obracania tekstu dla komórek w zakresie.
setTextRotation(rotation)RangeUstawia ustawienia obracania tekstu dla komórek w zakresie.
setTextRotations(rotations)RangeUstawia prostokątną siatkę obrotów tekstu.
setTextStyle(style)RangeUstawia styl tekstu w komórkach w zakresie.
setTextStyles(styles)RangeUstawia prostokątną siatkę stylów tekstu.
setValue(value)RangeUstawia wartość zakresu.
setValues(values)RangeUstawia prostokątną siatkę wartości (musi być zgodna z wymiarami tego zakresu).
setVerticalAlignment(alignment)RangeUstaw wyrównanie pionowe (od góry do dołu) dla danego zakresu (góra/środek/dół).
setVerticalAlignments(alignments)RangeUstawia prostokątną siatkę wyrównania pionowego (musi odpowiadać wymiarom tego zakresu).
setVerticalText(isVertical)RangeOkreśla, czy tekst w komórkach w zakresie ma być ułożony w stos.
setWrap(isWrapEnabled)RangeUstaw zawijanie komórek w danym zakresie.
setWrapStrategies(strategies)RangeUstawia prostokątną siatkę strategii owinięcia.
setWrapStrategy(strategy)RangeUstawia strategię przenoszenia tekstu w komórkach w zakresie.
setWraps(isWrapEnabled)RangeUstawia prostokątną siatkę zasad przełamania tekstu (musi być zgodna z wymiarami tego zakresu).
shiftColumnGroupDepth(delta)RangeZmienia głębokość grupowania kolumn zakresu o określoną wartość.
shiftRowGroupDepth(delta)RangeZmienia głębokość grupowania wierszy zakresu o określoną wartość.
sort(sortSpecObj)RangeSortuje komórki w podanym zakresie według określonej kolumny i kolejności.
splitTextToColumns()voidDzieli kolumnę tekstu na wiele kolumn na podstawie automatycznie wykrytego separatora.
splitTextToColumns(delimiter)voidDzieli kolumnę tekstu na wiele kolumn, używając określonego ciągu znaków jako ogranicznika niestandardowego.
splitTextToColumns(delimiter)voidDzieli kolumnę tekstu na wiele kolumn na podstawie określonego separatora.
trimWhitespace()RangeObcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce w tym zakresie.
uncheck()RangeStan pól wyboru w zakresie zostanie zmieniony na „niezaznaczone”.

Szczegółowa dokumentacja

activate()

Ustawia określony zakres jako active range, a komórkę w lewym górnym rogu zakresu jako current cell.

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

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

Powrót

Range – ten zakres do łańcuchowania.


activateAsCurrentCell()

Ustawia wskazaną komórkę jako current cell.

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

Jeśli wybrana komórka nie znajduje się w żadnym istniejącym zakresie, dotychczasowe zaznaczenie zostanie usunięte, a komórka stanie się bieżącą komórką i aktywnym zakresem.

Uwaga: podana tablica Range musi składać się z jednej komórki, w przeciwnym razie zostanie zgłoszona wyjątek.

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

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 metadane dewelopera z określonym kluczem 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 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 nowych metadanych dewelopera.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 metadanych 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 nowych metadanych dewelopera.
visibilityDeveloperMetadataVisibilitywidoczność nowych metadanych dewelopera.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 nowych metadanych dewelopera.
valueStringWartość nowych metadanych dewelopera.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 metadanych dewelopera z określonym kluczem, wartością 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 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 nowych metadanych dewelopera.
valueStringWartość nowych metadanych dewelopera.
visibilityDeveloperMetadataVisibilitywidoczność nowych metadanych dewelopera.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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()

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

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

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

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

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

Autoryzacja

Skrypty, które korzystają z tej 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 paski mają kolor nagłówka i stopki.

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

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

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

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

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

Parametry

NazwaTypOpis
bandingThemeBandingThemeMotyw kolorystyczny, który ma być zastosowany do kolumn w zakresie.

Powrót

Banding – nowe pasmo.

Autoryzacja

Skrypty, które korzystają z tej 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, który ma być zastosowany do kolumn w zakresie.
showHeaderBooleanJeśli true, do pierwszej kolumny zostanie zastosowany kolor nagłówka motywu paska.
showFooterBooleanJeśli true, do ostatniej kolumny zostanie zastosowany kolor stopki motywu paska.

Powrót

Banding – nowe pasmo.

Autoryzacja

Skrypty, które korzystają z tej 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()

Do zakresu zostanie zastosowany domyślny motyw pasków wierszy. Domyślnie paski mają kolor nagłówka, ale 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 – pasy.

Autoryzacja

Skrypty, które korzystają z tej 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 paski mają kolor nagłówka, ale 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, który ma być stosowany do wierszy w zakresie.

Powrót

Banding – nowe pasmo.

Autoryzacja

Skrypty, które korzystają z tej 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, który ma być stosowany do wierszy w zakresie.
showHeaderBooleanJeśli true, do pierwszego wiersza zostanie zastosowany kolor nagłówka motywu pasków.
showFooterBooleanJeśli true, do ostatniego wiersza zostanie zastosowany kolor stopki motywu paska.

Powrót

Banding – nowe pasmo.

Autoryzacja

Skrypty, które korzystają z tej 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 element destinationRange danymi na podstawie danych z tego zakresu. Nowe wartości są również określane przez określony typ series. Zakres docelowy musi zawierać ten zakres i rozszerzać go tylko w jednym kierunku. Na przykład poniższy kod wypełnia komórkę A1:A20szeregiem rosnących liczb na podstawie bieżących wartości w komórce A1:A20:A1:A4

const sheet = SpreadsheetApp.getActiveSheet();

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

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

Parametry

NazwaTypOpis
destinationRangeZakres, który ma być automatycznie wypełniany wartościami. Zakres docelowy powinien zawierać ten zakres i rozszerzać go tylko w jednym kierunku (w górę, w dół, w lewo lub w prawo).
seriesAutoFillSeriesTyp serii autoFill, która powinna być używana do obliczania nowych wartości. Efekt tej serii zależy od typu i ilości danych źródłowych.

Autoryzacja

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

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

autoFillToNeighbor(series)

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

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

Jeśli np. tablica A1:A20 jest wypełniona serią 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 tablicy B5:B20. W ten sposób nowe wartości „przyklejają się” do komórek zawierających wartości w kolumnie A.

const sheet = SpreadsheetApp.getActiveSheet();

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

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

Parametry

NazwaTypOpis
seriesAutoFillSeriesTyp serii autoFill, która powinna być używana do obliczania nowych wartości. Efekt tej serii zależy od typu i ilości danych źródłowych.

Autoryzacja

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

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

breakApart()

Ponownie podziel wszystkie komórki wielokolumnowe w zakresie na pojedyncze komórki.

Wykonywanie tej funkcji na zakresie jest równoznaczne z wybraniem zakresu i kliknięciem Format > Scal komórki > Rozłącz komórki.

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

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

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 może zawsze 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 edycji każdej komórki w zakresie; falsew przeciwnym razie.

Autoryzacja

Skrypty, które korzystają z tej 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”. Pomija komórki w zakresie, które nie zawierają obecnie skonfigurowanej wartości zaznaczonej ani niezaznaczonej.

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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()

Wyczyść zakres treści i formatów.

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

Czyści zakres treści, format, reguły sprawdzania poprawności danych lub komentarze zgodnie z danymi opcjami zaawansowanymi. Domyślnie wszystkie dane są usuwane.

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

Parametry

NazwaTypOpis
optionsObjectObiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
commentsOnlyBooleanOkreśla, czy usunąć tylko komentarze.
contentsOnlyBooleanOkreśla, czy ma zostać wyczyszczona tylko zawartość.
formatOnlyBooleanCzy wyczyścić tylko format. Pamiętaj, że wyczyszczenie formatu spowoduje też usunięcie reguł sprawdzania poprawności danych.
validationsOnlyBooleanOkreśl, czy chcesz usunąć tylko reguły sprawdzania poprawności danych.
skipFilteredRowsBooleanOkreśla, czy należy unikać usuwania odfiltrowanych wierszy.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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, pozostawiając formatowanie.

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 zakresie.

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 z tego zakresu.

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

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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()

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

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

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

Powrót

Range – ten zakres do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej 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 mieszczą się całkowicie w zakresie. Jeśli żadna grupa nie mieści się w całości w zakresie, zwijana jest najbardziej rozwinięta grupa, która częściowo mieści się w zakresie.

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 zakres docelowy jest większy lub mniejszy niż zakres źródłowy, źródło jest odpowiednio powtarzane lub obcinane. Pamiętaj, że ta metoda kopiuje tylko formatowanie.

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

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

const range = source.getRange('B2:D4');

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

Parametry

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

Autoryzacja

Skrypty, które korzystają z tej 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 zakres docelowy jest większy lub mniejszy niż zakres źródłowy, źródło jest odpowiednio powtarzane lub obcinane. Pamiętaj, że ta metoda kopiuje tylko formatowanie.

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

const range = source.getRange('B2:D4');

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

Parametry

NazwaTypOpis
sheetSheetArkusz docelowy.
columnIntegerPierwsza kolumna zakresu docelowego.
columnEndIntegerKolumna końcowa zakresu docelowego.
rowIntegerPierwszy wiersz zakresu docelowego.
rowEndIntegerWiersz końcowy zakresu docelowego.

Autoryzacja

Skrypty, które korzystają z tej 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)

Skopiuj dane z zakresu komórek do innego zakresu komórek. Skopiowane zostaną zarówno wartości, jak i formatowanie.

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

Parametry

NazwaTypOpis
destinationRangeZakres docelowy, do którego mają zostać skopiowane dane. Ważna jest tylko pozycja komórki w lewym górnym rogu.

Autoryzacja

Skrypty, które korzystają z tej 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)

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

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

Parametry

NazwaTypOpis
destinationRangeZakres docelowy, do którego mają zostać skopiowane dane. Ważna 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 być wklejony w odwróconej orientacji.

Autoryzacja

Skrypty, które korzystają z tej 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)

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

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

Parametry

NazwaTypOpis
destinationRangeZakres docelowy, do którego mają zostać skopiowane dane. Ważna jest tylko pozycja komórki w lewym górnym rogu.
optionsObjectObiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
formatOnlyBooleanoznacza, że należy skopiować tylko format.
contentsOnlyBooleanoznacza, że należy skopiować tylko zawartość.

Autoryzacja

Skrypty, które korzystają z tej 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 zakres docelowy jest większy lub mniejszy niż zakres źródłowy, źródło jest odpowiednio powtarzane lub przycinane.

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

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

const range = source.getRange('B2:D4');

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

Parametry

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

Autoryzacja

Skrypty, które korzystają z tej 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 zakres docelowy jest większy lub mniejszy niż zakres źródłowy, źródło jest odpowiednio powtarzane lub przycinane.

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

const range = source.getRange('B2:D4');

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

Parametry

NazwaTypOpis
sheetSheetArkusz docelowy.
columnIntegerPierwsza kolumna zakresu docelowego.
columnEndIntegerKolumna końcowa zakresu docelowego.
rowIntegerPierwszy wiersz zakresu docelowego.
rowEndIntegerWiersz końcowy zakresu docelowego.

Autoryzacja

Skrypty, które korzystają z tej 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 pustą tabelę przestawną źródła danych na podstawie tego źródła danych, przypięta do pierwszej komórki w tym zakresie.

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

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

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

Parametry

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 pustą tabelę źródła danych na podstawie źródła danych, zadokowaną w pierwszej komórce tego zakresu.

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

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

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

Parametry

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 API „DeveloperMetadataFinderApi” służący do znajdowania metadanych dewelopera w zakresie tego zakresu. Metadane mieszczą się w zakresie tylko wtedy, gdy są w pełni zawarte w tym zakresie. Na przykład metadane powiązane z wierszem „3:3” nie są objęte zakresem „A1:D5”, ale są objęte zakresem „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 do wyszukiwania metadanych w zakresie tego zakresu.


createFilter()

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

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');

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

Powrót

Filter – nowy filtr.

Autoryzacja

Skrypty, które korzystają z tej 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ą na podstawie określonego zakresu sourceData, który jest zakotwiczony w pierwszej komórce tego zakresu.

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

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

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

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

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

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

Parametry

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

Powrót

PivotTable – nowo utworzona PivotTable.

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

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

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

Parametry

NazwaTypOpis
findTextStringTekst, który chcesz wyszukać.

Powrót

TextFinder – TextFinder dla zakresu


deleteCells(shiftDimension)

Usuwa ten zakres komórek. Istniejące dane na arkuszu według podanego wymiaru są przesuwane w kierunku usuniętego zakresu.

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

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

Parametry

NazwaTypOpis
shiftDimensionDimensionWymiar, w którym mają zostać przesunięte istniejące dane.

Autoryzacja

Skrypty, które korzystają z tej 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ętych grup, których zakres lub przełącznik kontrolny przecina się z tym zakresem. Lokalizacja przełącznika to indeks, w którym przełącznik jest wyświetlany, bezpośrednio przed grupą lub po niej, w zależności od ustawień. Jeśli w tym samym miejscu jest więcej niż 1 grupa, rozwinięta zostanie grupa o najmniejszej głębokości.

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 ciąg tekstowy opisujący zakres w notacji A1.

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

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

Powrót

String – ciąg znaków opisujący zakres w notacji A1.

Autoryzacja

Skrypty, które korzystają z tej 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 w zakresie (np. '#ffffff').

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

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

Powrót

String – kod koloru tła.

Autoryzacja

Skrypty, które korzystają z tej 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 w zakresie.

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

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

Powrót

Color – kolor tła lewego górnego rogu komórki w zakresie.

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 (na przykład '#ffffff').

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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, które są stosowane do komórek w tym zakresie.

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

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

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

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 podawaną komórkę w zakresie.

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

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

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

Parametry

NazwaTypOpis
rowIntegerWiersz komórki względem zakresu.
columnIntegerKolumna komórki względem zakresu.

Powrót

Range – zakres obejmujący pojedynczą komórkę w określonych współrzędnych.

Autoryzacja

Skrypty, które korzystają z tej 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ę początkową kolumny w przypadku tego zakresu.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 kierunkach Direction, aby objąć wszystkie sąsiednie komórki z danymi. Jeśli zakres jest otoczony pustymi komórkami, z wyjątkiem tych na przekątnych, zwracany jest sam zakres. Jest to podobne do wybrania zakresu i wpisania Ctrl+A w edytorze.

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

Powrót

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

Autoryzacja

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

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

getDataRegion(dimension)

Zwraca kopię zakresu rozwiniętego Direction.UP i Direction.DOWN, jeśli podany wymiar to Dimension.ROWS, lub Direction.NEXT i Direction.PREVIOUS, jeśli wymiar to Dimension.COLUMNS. Rozszerzenie zakresu odbywa się na podstawie wykrycia danych obok zakresu, które są uporządkowane w postaci tabeli. Rozwinięty zakres obejmuje wszystkie sąsiednie komórki z danymi w wybranym wymiarze, w tym na granicach tabeli. Jeśli pierwotny zakres jest otoczony pustymi komórkami wzdłuż określonego wymiaru, zwracany jest sam zakres. Ta metoda jest podobna do wybierania zakresu i wstawiania w edytorze znaku Ctrl+Space w przypadku kolumn lub Shift+Space w przypadku wierszy.

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

Parametry

NazwaTypOpis
dimensionDimensionWymiar, wzdłuż którego chcesz rozwinąć zakres.

Powrót

Range – region danych zakresu lub zakres obejmujący każdą kolumnę lub każdy wiersz objęty przez pierwotny zakres.

Autoryzacja

Skrypty, które korzystają z tej 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 wartość 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.

Autoryzacja

Skrypty, które korzystają z tej 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 DataSourceFormula komórek w zakresie.

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

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

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

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

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

Powrót

DataSourceFormula[] – tablica elementów typu DataSourceFormula.

Autoryzacja

Skrypty, które korzystają z tej 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ódeł danych, które pokrywają 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.

Autoryzacja

Skrypty, które korzystają z tej 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, które pokrywają 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 the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

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

Powrót

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

Autoryzacja

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

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

getDataSourceUrl()

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

Code.gs

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

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

piechart.html

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

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

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

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

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

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

Powrót

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

Autoryzacja

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

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

getDataTable()

Zwraca dane z tego obiektu jako DataTable.

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

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

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

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

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

Powrót

DataTable – dane w postaci tabeli danych.


getDataTable(firstRowIsHeader)

Zwraca dane z tego zakresu jako DataTable.

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

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

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

Parametry

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

Powrót

DataTable – dane w postaci tabeli danych.

Autoryzacja

Skrypty, które korzystają z tej 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 komórki w lewym górnym rogu zakresu. Jeśli w komórce nie jest ustawione sprawdzanie poprawności danych, metoda zwraca null.

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

Powrót

DataValidation – reguła sprawdzania poprawności danych w lewym górnym rogu komórki w zakresie.

Autoryzacja

Skrypty, które korzystają z tej 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 jest ustawione sprawdzanie poprawności danych, ta 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

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

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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.

Autoryzacja

Skrypty, które korzystają z tej 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ść komórki w lewym górnym rogu zakresu. Wartość to String. Wyświetlana wartość uwzględnia formatowanie daty, czasu i waluty, w tym formaty stosowane automatycznie przez ustawienie języka i regionu w arkuszu kalkulacyjnym. Puste komórki zwracają pusty ciąg znaków.

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

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

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 dla tego zakresu.

Zwraca dwuwymiarową tablicę wyświetlanych wartości, indeksowaną według wiersza, a następnie według kolumny. Wartości to obiekty String. Wyświetlana wartość uwzględnia formatowanie daty, czasu i waluty, w tym formaty stosowane automatycznie przez ustawienie regionu arkusza kalkulacyjnego. Pustych komórek nie ma w tablicy. Pamiętaj, że indeks zakresu zaczyna się od 1, 1, a indeksowanie tablicy JavaScript zaczyna się od [0][0].

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

Powrót

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

Autoryzacja

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

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

getFilter()

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

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

Powrót

Filter – filtr.

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 komórek w zakresie.

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

const results = range.getFontColorObjects();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 komórek w zakresie.

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

const results = range.getFontFamilies();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getFontFamily());

Powrót

String – rodzina czcionek komórki.

Autoryzacja

Skrypty, które korzystają z tej 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').

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

Logger.log(range.getFontLine());

Powrót

String – wiersz czcionki.

Autoryzacja

Skrypty, które korzystają z tej 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').

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

const results = range.getFontLines();

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

Powrót

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

Autoryzacja

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

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

getFontSize()

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

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

Logger.log(range.getFontSize());

Powrót

Integer – rozmiar czcionki w punktach.

Autoryzacja

Skrypty, które korzystają z tej 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 komórek w zakresie.

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

const results = range.getFontSizes();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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.

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

Logger.log(range.getFontStyle());

Powrót

String – styl czcionki tekstu w komórce.

Autoryzacja

Skrypty, które korzystają z tej 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 komórek w zakresie.

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

const results = range.getFontStyles();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 wagę czcionki (normalna/pogrubiona) komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getFontWeight());

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 wagi czcionek komórek w zakresie.

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

const results = range.getFontWeights();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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łę (notacja A1) komórki lewej górnej zakresu lub pusty ciąg znaków, jeśli komórka jest pusta lub nie zawiera formuły.

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

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

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

Powrót

String – formuła komórki.

Autoryzacja

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

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

getFormulaR1C1()

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

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

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

Powrót

String – formuła w notacji R1C1.

Autoryzacja

Skrypty, które korzystają z tej 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) komórek w zakresie. Wpisy w tablicy dwuwymiarowej to puste ciągi znaków w przypadku komórek bez formuły.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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) komórek w zakresie. Wpisy w tablicy dwuwymiarowej to null w przypadku komórek bez formuły.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 typu int.

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

Logger.log(range.getGridId());

Powrót

Integer – identyfikator siatki arkusza nadrzędnego.

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

Powrót

Integer – wysokość zakresu.

Autoryzacja

Skrypty, które korzystają z tej 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 poziome tekstu (lewo/środku/prawo) komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getHorizontalAlignment());

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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.

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

const results = range.getHorizontalAlignments();

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

Powrót

String[][] – dwuwymiarowy tablicowy zbiór wyrównań poziomych tekstu powiązanego z komórkami w zakresie.

Autoryzacja

Skrypty, które korzystają z tej 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ę kolumny końcowej.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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ńcowego wiersza.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

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

Powrót

Range[] – tablica obiektów Range, która reprezentuje scalone komórki nakładające się na zakres.


getNextDataCell(direction)

Zaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w danym kierunku, która jest krawędzią ciągłego zakresu komórek z danymi lub komórką na krawędzi arkusza w tym kierunku. Jest to równoznaczne z wpisaniem w edytorze Ctrl+[arrow key].

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

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

Parametry

NazwaTypOpis
directionDirectionKierunek, w którym znajduje się następna komórka krawędzi regionu danych.

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 danym zakresem.

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

Logger.log(range.getNote());

Powrót

String – nota związana z daną komórką.

Autoryzacja

Skrypty, które korzystają z tej 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.

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

const results = range.getNotes();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

Powrót

Integer – liczba kolumn w tym zakresie.

Autoryzacja

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

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

getNumRows()

Zwraca liczbę wierszy w tym zakresie.

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

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

Powrót

Integer – liczba wierszy w tym zakresie.

Autoryzacja

Skrypty, które korzystają z tej 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()

Pobiera format liczby lub daty komórki w lewym górnym rogu danego zakresu. Zwracane wzorce formatowania są opisane w dokumentacji interfejsu Sheets API.

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

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

Powrót

String – format liczby w lewym górnym rogu komórki w zakresie.

Autoryzacja

Skrypty, które korzystają z tej 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 formaty liczb lub dat dla komórek w zakresie. Zwracane wzorce formatu są opisane w dokumentacji interfejsu Sheets API.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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ść sformatowanego tekstu w lewej górnej komórce zakresu lub null, jeśli wartość komórki nie jest tekstem.

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 sformatowanego tekstu w komórkach w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 w przypadku tego zakresu. Funkcja ta jest identyczna z getRowIndex().

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

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

Powrót

Integer – pozycja wiersza zakresu.

Autoryzacja

Skrypty, które korzystają z tej 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 w przypadku tego zakresu. To samo co getRow().

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

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

Powrót

Integer – pozycja wiersza zakresu.

Autoryzacja

Skrypty, które korzystają z tej 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 ten zakres.

Autoryzacja

Skrypty, które korzystają z tej 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 w lewym górnym rogu komórki zakresu. Zwraca null, jeśli kierunek tekstu w komórce jest określany automatycznie.

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 tekstowe kierunki dla komórek w zakresie. Wpisy w macierzy dwuwymiarowej mają wartość null w komórkach używających automatycznego wykrywania.

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

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

Powrót

TextDirection[][] – dwuwymiarowy tablica kierunków tekstowych.

Autoryzacja

Skrypty, które korzystają z tej 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 obracania tekstu w lewej górnej komórce zakresu.

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

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

Powrót

TextRotation – ustawienia rotacji tekstu.

Autoryzacja

Skrypty, które korzystają z tej 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 obracania tekstu w komórkach w zakresie.

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

const results = range.getTextRotations();

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 w lewym górnym rogu komórki zakresu.

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

Powrót

TextStyle – styl tekstu w lewej górnej komórce zakresu.

Autoryzacja

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

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

getTextStyles()

Zwraca style tekstu w komórkach w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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ść komórki lewej górnej części zakresu. Wartość może być typu Number, Boolean, Date lub String w zależności od wartości komórki. Puste komórki zwracają pusty ciąg.

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

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

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

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

Powrót

Object – wartość w tej komórce.

Autoryzacja

Skrypty, które korzystają z tej 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 dla tego zakresu.

Zwraca dwuwymiarową tablicę wartości, indeksowaną według wiersza, a następnie według kolumny. Wartości mogą być typu Number, Boolean, Date lub String w zależności od wartości komórki. Pustych komórek nie ma w tablicy, a ich miejsce zajmuje pusty ciąg. Pamiętaj, że indeks zakresu zaczyna się od 1, 1, a tablica JavaScript jest indeksowana od [0][0].

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 pionowe (góra/środek/dół) komórki w lewym górnym rogu zakresu.

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

Logger.log(range.getVerticalAlignment());

Powrót

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

Autoryzacja

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

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

getVerticalAlignments()

Zwraca wyrównanie pionowe komórek w zakresie.

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

const results = range.getVerticalAlignments();

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

Powrót

String[][] – dwuwymiarowy tablicowy zbiór wyrównania pionowego tekstu powiązanego z komórkami w zakresie.

Autoryzacja

Skrypty, które korzystają z tej 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.

Autoryzacja

Skrypty, które korzystają z tej 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ę skrótów, użyj elementu getWrapStrategy().

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

Logger.log(range.getWrap());

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 przenoszenia tekstu w komórkach w zakresie.

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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ę przenoszenia tekstu w lewej górnej komórce zakresu.

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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ę skrótów, użyj elementu getWrapStrategies().

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

const results = range.getVerticalAlignments();

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

Powrót

Boolean[][] – dwuwymiarowy tablicowy zbiór wyrównania pionowego tekstu powiązanego z komórkami w zakresie.

Autoryzacja

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

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

insertCells(shiftDimension)

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

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

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

Parametry

NazwaTypOpis
shiftDimensionDimensionWymiar, w którym mają zostać przesunięte istniejące dane.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

insertCheckboxes()

Wstawia pola wyboru w każdej komórce w zakresie, skonfigurowane za pomocą true dla zaznaczonych i false dla niezaznaczonych. Ustawia wartość wszystkich komórek w zakresie na false.

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

insertCheckboxes(checkedValue)

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

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

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

Parametry

NazwaTypOpis
checkedValueObjectZaznaczona wartość walidacji danych pola wyboru.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

insertCheckboxes(checkedValue, uncheckedValue)

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

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

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

Parametry

NazwaTypOpis
checkedValueObjectZaznaczona wartość walidacji danych pola wyboru.
uncheckedValueObjectWartość niezaznaczonego pola wyboru w przypadku walidacji danych.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 true, jeśli zakres jest całkowicie pusty.

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

Logger.log(range.isBlank());

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 wartość wskazującą, czy stan pola wyboru we wszystkich komórkach w zakresie to „zaznaczone”. Zwraca wartość null, jeśli niektóre komórki są zaznaczone, a pozostałe nie, lub jeśli niektóre komórki nie mają pola wyboru weryfikacji danych.

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

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

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

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

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

Powrót

Boolean – true, jeśli wszystkie komórki w zakresie są zaznaczone, false, jeśli wszystkie komórki w zakresie są niezaznaczone, lub null, jeśli którakolwiek z komórek jest niezaznaczona lub nie ma walidacji danych za pomocą pola wyboru.

Autoryzacja

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

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

isEndColumnBounded()

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

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

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

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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, zwraca false.

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

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

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

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

Powrót

Boolean – true, jeśli zakres zachodzi 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 powiązany tylko z wierszem na początku zakresu, zwraca false.

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

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

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

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

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej 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 określonym wierszem. Na przykład w przypadku zakresów A1:B10 lub 3:7, które są powiązane z wierszami na początku zakresu, ta metoda zwraca true; w przypadku zakresu B:B, który jest powiązany tylko z konkretną kolumną na początku zakresu, zwraca false.

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

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

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

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

Powrót

Boolean – true, jeśli początek zakresu jest powiązany z określonym wierszem; falsew przeciwnym razie.

Autoryzacja

Skrypty, które korzystają z tej 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()

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

const sheet = SpreadsheetApp.getActiveSheet();

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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()

scalić komórki w zakresie w kolumnach zakresu;

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

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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()

Scal komórki w zakresie.

const sheet = SpreadsheetApp.getActiveSheet();

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 docelowego zakresu.

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

Parametry

NazwaTypOpis
targetRangeDocelowy zakres, do którego ma zostać skopiowany ten zakres. Istotne jest tylko położenie komórki w lewym górnym rogu.

Autoryzacja

Skrypty, które korzystają z tej 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 przesunięty względem tego zakresu o określoną liczbę wierszy i kolumn (która może być ujemna). Nowy zakres ma taki sam rozmiar jak pierwotny.

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

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

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

Parametry

NazwaTypOpis
rowOffsetIntegerLiczba wierszy poniżej komórki lewym górnym na zakresie; wartości ujemne wskazują wiersze powyżej komórki lewym górnym na zakresie.
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 do łańcuchowania.


offset(rowOffset, columnOffset, numRows)

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

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

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

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

Parametry

NazwaTypOpis
rowOffsetIntegerLiczba wierszy poniżej komórki lewym górnym na zakresie; wartości ujemne wskazują wiersze powyżej komórki lewym górnym na zakresie.
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ść nowego zakresu w wierszach.

Powrót

Range – ten zakres do łańcuchowania.


offset(rowOffset, columnOffset, numRows, numColumns)

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

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

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

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

Parametry

NazwaTypOpis
rowOffsetIntegerLiczba wierszy poniżej komórki lewym górnym na zakresie; wartości ujemne wskazują wiersze powyżej komórki lewym górnym na zakresie.
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ść nowego zakresu w wierszach.
numColumnsIntegerSzerokość nowych kolumn w zakresie.

Powrót

Range – ten zakres do łańcuchowania.


protect()

Tworzy obiekt, który może chronić zakres przed edytowaniem przez użytkowników, którzy nie mają uprawnień. Dopóki skrypt nie zmieni listy edytujących zakres (wywołując Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) lub ustawiając nową wartość dla Protection.setDomainEdit(editable)), uprawnienia będą takie same jak w arkuszu kalkulacyjnym, co oznacza, że zakres pozostanie niezabezpieczony. Jeśli zakres jest już chroniony, ta metoda tworzy nowy chroniony zakres, który pokrywa się z dotychczasowym. Jeśli komórka jest chroniona przez wiele chronionych zakresów, a każdy z nich uniemożliwia konkretnemu użytkownikowi jej edytowanie, ten użytkownik nie może edytować tej komórki.

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

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

Powrót

Protection – obiekt reprezentujący ustawienia ochrony.

Autoryzacja

Skrypty, które korzystają z tej 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()

Losowo zmienia kolejność wierszy w danym zakresie.

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

// Randomizes the range
range.randomize();

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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. Usuwa sprawdzanie poprawności danych z każdej komórki, a dodatkowo usuwa jej wartość, jeśli zawiera ona wartość zaznaczoną lub niezaznaczoną.

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

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

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

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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()

Usuń wiersze w tym zakresie, które zawierają wartości będące duplikatami wartości w dowolnym poprzednim wierszu. Wiersze z identycznymi wartościami, które różnią się wielkością liter, formatowaniem lub formułami, są uznawane za duplikaty. Ta metoda usuwa też zduplikowane wiersze ukryte przed widokiem (np. z powodu filtra). Treści spoza tego zakresu nie są usuwane.

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

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

Powrót

Range – zakres wynikowy po usunięciu duplikatów. Rozmiar zakresu zmniejsza się o wiersz za każdym usuniętym wierszem.

Autoryzacja

Skrypty, które korzystają z tej 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 w tym zakresie, które zawierają w określonych kolumnach 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 przed widokiem (np. z powodu filtra). Treści spoza tego zakresu nie są usuwane.

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

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

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

Parametry

NazwaTypOpis
columnsToCompareInteger[]Kolumny, które mają być analizowane pod kątem duplikatów wartości. Jeśli nie podasz żadnych kolumn, wszystkie kolumny zostaną przeanalizowane pod kątem duplikatów.

Powrót

Range – zakres wynikowy po usunięciu duplikatów. Rozmiar zakresu zmniejsza się o wiersz za każdym usuniętym wierszem.

Autoryzacja

Skrypty, które korzystają z tej 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 za pomocą notacji CSS (np. '#ffffff'lub 'white').

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

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

Parametry

NazwaTypOpis
colorStringKod koloru w notacji CSS (np. '#ffffff' lub 'white'); wartość null zeruje kolor.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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.

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

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

Parametry

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę kolorów tła (musi odpowiadać wymiarom tego zakresu).

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

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

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

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

Parametry

NazwaTypOpis
colorColor[][]Dwudwumiarowa tablica kolorów; wartości null zresetowują kolor.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 tło na dany kolor za pomocą wartości RGB (liczb całkowitych z zakresu od 0 do 255 włącznie).

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

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

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

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

Parametry

NazwaTypOpis
redIntegerWartość czerwonego w notacji RGB.
greenIntegerWartość zielonego w notacji RGB.
blueIntegerWartość niebieskiego w notacji RGB.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę kolorów tła (musi odpowiadać wymiarom tego zakresu). Kolory są podane w notacji CSS (np. '#ffffff' lub 'white').

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

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

const cell = sheet.getRange('B5:D6');
cell.setBackgrounds(colors);

Parametry

NazwaTypOpis
colorString[][]Dwudwuwymiarowa tablica kolorów w notacji CSS (np. '#ffffff' lub 'white'); wartości null zresetują kolor.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

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

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

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

const cell = sheet.getRange('B2');
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parametry

NazwaTypOpis
topBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
leftBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
bottomBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
rightBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
verticalBooleantrue – wewnętrzne pionowe obramowania, false – brak obramowania, null – brak zmian.
horizontalBooleantrue – wewnętrzne poziome obramowania, false – brak obramowania, null – brak zmian.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

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

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

const cell = sheet.getRange('B2');
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

Parametry

NazwaTypOpis
topBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
leftBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
bottomBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
rightBooleantrue oznacza obramowanie, false brak obramowania, null brak zmian.
verticalBooleantrue – wewnętrzne pionowe obramowania, false – brak obramowania, null – brak zmian.
horizontalBooleantrue – wewnętrzne poziome obramowania, false – brak obramowania, null – brak zmian.
colorStringKolor w notacji CSS (np. '#ffffff' lub 'white'), null dla koloru domyślnego (czarnego).
styleBorderStyleStyl obramowania, null dla stylu domyślnego (ciągłego).

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametry

NazwaTypOpis
ruleDataValidationRegułę sprawdzania poprawności danych do ustawienia lub null, aby usunąć sprawdzanie poprawności danych.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

setDataValidations(rules)

Ustawia reguły sprawdzania poprawności danych we wszystkich komórkach w zakresie. Ta metoda przyjmuje dwuwymiarową tablicę walidacji danych, indeksowaną według wiersza, a następnie według kolumny. Wymiary tablicy muszą być zgodne z wymiarami zakresu.

// Set the data validation rules for Sheet1!A1:B5 to require a value from
// Sheet2!A1:A10.
const destinationRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
const sourceRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
const rules = destinationRange.getDataValidations();
for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parametry

NazwaTypOpis
rulesDataValidation[][]Dwowymiarowa tablica reguł sprawdzania poprawności danych do ustawienia; wartości null powodują usunięcie sprawdzania poprawności danych.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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').

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

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

Parametry

NazwaTypOpis
colorStringKolor czcionki w notacji CSS (np. '#ffffff' lub 'white'); wartość null zeruje kolor.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

setFontColorObject(color)

Ustawia kolor czcionki w danym zakresie.

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

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

Parametry

NazwaTypOpis
colorColorKolor czcionki do ustawienia; wartość null powoduje zresetowanie koloru.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę kolorów czcionek (musi odpowiadać wymiarom tego zakresu).

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

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

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

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

Parametry

NazwaTypOpis
colorsColor[][]Dwudwumiarowy tablica kolorów; wartości null zresetują kolor czcionki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę kolorów czcionek (musi odpowiadać wymiarom tego zakresu). Kolory są podane w notacji CSS (np. '#ffffff' lub 'white').

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

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

const cell = sheet.getRange('B5:D6');
cell.setFontColors(colors);

Parametry

NazwaTypOpis
colorsObject[][]Dwudwuwymiarowa tablica kolorów w notacji CSS (np. '#ffffff' lub 'white'); wartości null zresetują kolor.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 (musi odpowiadać wymiarom tego zakresu). Przykładami rodzin czcionek są „Arial” lub „Helvetica”.

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

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

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

Parametry

NazwaTypOpis
fontFamiliesObject[][]Dwudwumiarowy tablica rodzin czcionek; wartości null zresetuj rodzinę czcionek.

Powrót

Range – ten zakres do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej 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. „Arial” lub „Helvetica”.

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

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

Parametry

NazwaTypOpis
fontFamilyStringRodzina czcionek do ustawienia; wartość null zeruje rodzinę czcionek.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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').

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

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

Parametry

NazwaTypOpis
fontLineStringStyl linii czcionki: 'underline', 'line-through' lub 'none'; wartość null zeruje styl linii czcionki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 (musi być zgodna z wymiarami tego zakresu).

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

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

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

Parametry

NazwaTypOpis
fontLinesObject[][]Dwudymensyjna tablica stylów linii czcionki ('underline', 'line-through' lub 'none'); wartości null znoszą styl linii czcionki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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, który jest rozmiarem punktu.

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

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

Parametry

NazwaTypOpis
sizeIntegerRozmiar czcionki w punktach.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 (musi odpowiadać wymiarom tego zakresu). Rozmiary są podane w punktach.

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

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

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

Parametry

NazwaTypOpis
sizesObject[][]Dwowymiarowa tablica rozmiarów.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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').

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

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

Parametry

NazwaTypOpis
fontStyleStringStyl czcionki: 'italic' lub 'normal'. Wartość null zresetuje styl czcionki.

Powrót

Range – ten zakres do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej 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 (musi odpowiadać wymiarom tego zakresu).

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

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

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

Parametry

NazwaTypOpis
fontStylesObject[][]Dwudwumiarowa tablica stylów czcionek: 'italic' lub 'normal'; wartości null zresetują styl czcionki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 w danym zakresie (normalna/pogrubiona).

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

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

Parametry

NazwaTypOpis
fontWeightStringGrubość czcionki: 'bold' lub 'normal'; wartość null zeruje grubość czcionki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 czcionki (musi odpowiadać wymiarom tego zakresu). Przykładem wagi czcionki jest „pogrubienie”.

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

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

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Parametry

NazwaTypOpis
fontWeightsObject[][]Dwowymiarowa tablica grubości czcionki, 'bold' lub 'normal'; wartości null zresetowują grubość czcionki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

Zaktualizuje formułę dla tego zakresu. Podana formuła musi być w notacji A1.

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

const cell = sheet.getRange('B5');
cell.setFormula('=SUM(B3:B4)');

Parametry

NazwaTypOpis
formulaStringCiąg znaków reprezentujący formułę do ustawienia w komórce.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

Zaktualizuje formułę dla tego zakresu. Podana formuła musi być w notacji R1C1.

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

const cell = sheet.getRange('B5');
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parametry

NazwaTypOpis
formulaStringFormuła tekstowa.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ł (musi odpowiadać wymiarom tego zakresu). Podane formuły muszą być w notacji A1. Ta metoda przyjmuje dwuwymiarową tablicę formuł indeksowaną według wiersza, a potem według kolumny. Wymiary tablicy muszą być zgodne z wymiarami zakresu.

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

// This sets the formulas to be a row of sums, followed by a row of averages
// right below. The size of the two-dimensional array must match the size of the
// range.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Parametry

NazwaTypOpis
formulasString[][]Dwowymiarowa tablica ciągów tekstowych z formułami.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ł (musi odpowiadać wymiarom tego zakresu). Podane formuły muszą być zapisane w notacji R1C1.

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

// This creates formulas for a row of sums, followed by a row of averages.
const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])';
const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])';

// The size of the two-dimensional array must match the size of the range.
const formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove],
];

const cell = sheet.getRange('B5:D6');
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parametry

NazwaTypOpis
formulasString[][]Dwowymiarowa tablica formuł w formacie R1C1.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

setHorizontalAlignment(alignment)

Ustaw wyrównanie poziome (od lewej do prawej) dla danego zakresu (lewo/środku/prawo).

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

const cell = sheet.getRange('B2');
cell.setHorizontalAlignment('center');

Parametry

NazwaTypOpis
alignmentStringWyrównanie: 'left', 'center' lub 'normal'; wartość null zeruje wyrównanie.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ównania poziomego (zob. setHorizontalAlignment(alignment)).

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

// The size of the two-dimensional array must match the size of the range.
const horizontalAlignments = [['left', 'right', 'center']];

const range = sheet.getRange('B2:D2');
range.setHorizontalAlignments(horizontalAlignments);

Parametry

NazwaTypOpis
alignmentsObject[][]Dwowymiarowa tablica wyrównania: 'left', 'center' lub 'normal'; wartość null zeruje wyrównanie.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 notatkę na podaną wartość.

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

const cell = sheet.getRange('B2');
cell.setNote('This is a note');

Parametry

NazwaTypOpis
noteStringWartość notatki do ustawienia dla zakresu. Wartość null powoduje usunięcie notatki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

setNotes(notes)

Ustawia prostokątną siatkę notatek (musi odpowiadać wymiarom tego zakresu).

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

// The size of the two-dimensional array must match the size of the range.
const notes = [
  ['it goes', 'like this', 'the fourth, the fifth'],
  ['the minor fall', 'and the', 'major lift'],
];

const cell = sheet.getRange('B2:D3');
cell.setNotes(notes);

Parametry

NazwaTypOpis
notesObject[][]Dwowymiarowa tablica notatek; wartości null powodują usunięcie notatki.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 na podany ciąg znaków formatowania. Akceptowane wzorce formatów są opisane w dokumentacji interfejsu Sheets API.

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

const cell = sheet.getRange('B2');
// Always show 3 decimal points
cell.setNumberFormat('0.000');

Parametry

NazwaTypOpis
numberFormatStringCiąg tekstowy formatu liczby.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę formatów liczb lub dat (musi być zgodna z wymiarami tego zakresu). Wartości to ciągi znaków wzorców formatowania opisane w dokumentacji interfejsu Sheets API.

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

// The size of the two-dimensional array must match the size of the range.
const formats = [['0.000', '0,000,000', '$0.00']];

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Parametry

NazwaTypOpis
numberFormatsObject[][]Dwudwumiarowa tablica formatów liczb.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ść sformatowanego tekstu w komórkach w zakresie.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello"
// bolded.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Parametry

NazwaTypOpis
valueRichTextValuePożądana wartość sformatowanego tekstu.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 sformatowanego tekstu.

// Sets the cells in range A1:A2 to have Rich Text values.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const richTextA2 = SpreadsheetApp.newRichTextValue()
                       .setText('bold words, italic words')
                       .setTextStyle(0, 11, bold)
                       .setTextStyle(12, 24, italic)
                       .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parametry

NazwaTypOpis
valuesRichTextValue[][]Pożądane wartości sformatowanego tekstu.

Powrót

Range – ten zakres do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej 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 zakres ma zawierać hiperlinki.

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

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

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

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

Parametry

NazwaTypOpis
showHyperlinkBooleanOkreśla, czy wyświetlić hiperlink.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 w zakresie. Jeśli podany kierunek to null, kierunek jest wywnioskowany, a następnie ustawiany.

// Sets right-to-left text direction for the range.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametry

NazwaTypOpis
directionTextDirectionPożądany kierunek tekstu; jeśli null, kierunek jest określany przed ustawieniem.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę wskazówek tekstowych. Jeśli podany kierunek to null, kierunek jest wywnioskowany, a następnie ustawiany.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextDirections());

Parametry

NazwaTypOpis
directionsTextDirection[][]Pożądane kierunki tekstu; jeśli kierunek jest określony jako null, jest on zrozumiany przed ustawieniem.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

Ustawia ustawienia obracania tekstu dla komórek w zakresie. Wartość wejściowa odpowiada kątowi między standardową orientacją tekstu a pożądaną orientacją. Wartość 0 oznacza, że tekst ma standardową orientację.

W przypadku tekstu od lewej do prawej dodatnie nachylone kąty są skierowane przeciwnie do ruchu wskazówek zegara, a w przypadku tekstu od prawej do lewej – zgodnie z ruchem wskazówek zegara.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setTextRotation(45);

Parametry

NazwaTypOpis
degreesIntegerPożądany kąt między standardową orientacją a pożądaną orientacją. W przypadku tekstu od lewej do prawej kąty dodatnie są w kierunku przeciwnym do ruchu wskazówek zegara.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

Ustawia ustawienia obracania tekstu dla komórek w zakresie.

// Sets all cell's in range B2:D4 to have the same text rotation settings as
// cell A1.
const sheet = SpreadsheetApp.getActiveSheet();

const rotation = sheet.getRange('A1').getTextRotation();

sheet.getRange('B2:D4').setTextRotation(rotation);

Parametry

NazwaTypOpis
rotationTextRotationUstawienia rotacji tekstu.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę obrotów tekstu.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Parametry

NazwaTypOpis
rotationsTextRotation[][]Ustawienia rotacji tekstu.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

setTextStyle(style)

Ustawia styl tekstu w komórkach w zakresie.

// Sets the cells in range C5:D6 to have underlined size 15 font.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('C5:D6');
const style =
    SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build();
range.setTextStyle(style);

Parametry

NazwaTypOpis
styleTextStylePożądany styl tekstu.

Powrót

Range – ten zakres do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej 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
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const otherStyle = SpreadsheetApp.newTextStyle()
                       .setBold(true)
                       .setUnderline(true)
                       .setItalic(true)
                       .setForegroundColor('#335522')
                       .setFontSize(44)
                       .build();
range.setTextStyles([
  [bold, otherStyle],
  [otherStyle, bold],
]);

Parametry

NazwaTypOpis
stylesTextStyle[][]Styl tekstu, którego chcesz użyć.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

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

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

setValue(value)

Ustawia wartość zakresu. Wartość może być liczbą, ciągiem znaków, wartością logiczną lub datą. Jeśli zaczyna się od '=', jest interpretowany jako formuła.

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

const cell = sheet.getRange('B2');
cell.setValue(100);

Parametry

NazwaTypOpis
valueObjectWartość zakresu.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 (musi być zgodna z wymiarami tego zakresu). Jeśli wartość zaczyna się od =, jest interpretowana jako formuła.

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

// The size of the two-dimensional array must match the size of the range.
const values = [['2.000', '1,000,000', '$2.99']];

const range = sheet.getRange('B2:D2');
range.setValues(values);

Parametry

NazwaTypOpis
valuesObject[][]Dwudwumiarowa tablica wartości.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 pionowe (od góry do dołu) dla danego zakresu (góra/środek/dół).

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

const cell = sheet.getRange('B2');
cell.setVerticalAlignment('middle');

Parametry

NazwaTypOpis
alignmentStringWyrównanie: 'top', 'middle' lub 'bottom'; wartość null zeruje wyrównanie.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ównania pionowego (musi odpowiadać wymiarom tego zakresu).

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

// The size of the two-dimensional array must match the size of the range.
const alignments = [['top', 'middle', 'bottom']];

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parametry

NazwaTypOpis
alignmentsObject[][]Dwowymiarowa tablica wyrównania: 'top', 'middle' lub 'bottom'; wartość null zeruje wyrównanie.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 w komórkach w zakresie ma być ułożony w stos. Jeśli tekst jest ułożony w wielokrotne rzędy, ustawienie stopnia obrotu tekstu jest ignorowane.

// Sets all cell's in range B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Parametry

NazwaTypOpis
isVerticalBooleanOkreśla, czy tekst ma być ułożony w strefach.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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)

Ustaw zawijanie komórek w danym zakresie.

Komórki z włączoną opcją zawijania (domyślnie) zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z wyłączonym przewijaniem wyświetlają jak najwięcej treści bez zmiany rozmiaru komórki ani rozciągania tekstu na kilka linii.

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

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parametry

NazwaTypOpis
isWrapEnabledBooleanCzy tekst ma być zawijany.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 owinięcia.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setWrapStrategies(range1.getWrapStrategies());

Parametry

NazwaTypOpis
strategiesWrapStrategy[][]Wybrane strategie zawijania.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę przenoszenia tekstu w komórkach w zakresie.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametry

NazwaTypOpis
strategyWrapStrategyWybrana strategia zawijania.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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ę zasad przełamania tekstu (musi być zgodna z wymiarami tego zakresu). Komórki z włączoną opcją zawijania (domyślnie) zmieniają rozmiar, aby wyświetlić całą zawartość. Komórki z wyłączoną opcją przewijania wyświetlają jak najwięcej tekstu bez zmiany rozmiaru komórki ani rozciągania tekstu na kilka linii.

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

// The size of the two-dimensional array must match the size of the range.
const wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parametry

NazwaTypOpis
isWrapEnabledObject[][]Dwudwumiarowa tablica zmiennych zawijania, które określają, czy tekst w komórce ma być zawijany, czy nie.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 zakresu o określoną wartość.

W efekcie powoduje to utworzenie, zmodyfikowanie lub usunięcie grup, które pokrywają się z zakresem. W przypadku dodatnich wartości delta grupy są tworzone lub modyfikowane. W przypadku ujemnych wartości delta grupy są usuwane lub modyfikowane.

Nie ma to wpływu na zmniejszenie głębokości grupy poniżej 0 lub powyżej 8.

Jeśli column group control position to BEFORE, podczas próby zmiany głębokości pierwszej wiersza wystąpi błąd.

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

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parametry

NazwaTypOpis
deltaIntegerWartość, o którą ma się zmienić głębokość grupy kolumn w tym zakresie.

Powrót

Range – ten zakres do łańcuchowania.

Rzuty

Error – podczas próby zmiany głębokości pierwszej kolumny, gdy pozycja sterowania to GroupControlTogglePosition.BEFORE.

Autoryzacja

Skrypty, które korzystają z tej 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 zakresu o określoną wartość.

W efekcie powoduje to utworzenie, zmodyfikowanie lub usunięcie grup, które pokrywają się z zakresem. W przypadku dodatnich wartości delta grupy są tworzone lub modyfikowane. W przypadku ujemnych wartości delta grupy są usuwane lub modyfikowane.

Nie ma to wpływu na zmniejszenie głębokości grupy poniżej 0 lub powyżej 8.

Jeśli row group control position to BEFORE, podczas próby zmiany głębokości pierwszego wiersza wystąpi błąd.

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

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parametry

NazwaTypOpis
deltaIntegerWartość, o którą ma się zmienić głębokość grupy wierszy w tym zakresie.

Powrót

Range – ten zakres do łańcuchowania.

Rzuty

Error – podczas próby zmiany głębokości pierwszej wiersza, gdy pozycja elementu sterującego to GroupControlTogglePosition.BEFORE.

Autoryzacja

Skrypty, które korzystają z tej 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 określonej kolumny i kolejności.

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

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([
  {column: 2, ascending: false},
  {column: 1, ascending: true},
]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more
// readable code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([
  {column: 2, ascending: true},
  {column: 1, ascending: true},
]);

Parametry

NazwaTypOpis
sortSpecObjObjectKolumny, według których chcesz sortować.

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 wiele kolumn na podstawie automatycznie wykrytego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

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

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Autoryzacja

Skrypty, które korzystają z tej 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 wiele kolumn, używając określonego ciągu znaków jako ogranicznika niestandardowego.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametry

NazwaTypOpis
delimiterStringNiestandardowy separator, według którego ma nastąpić podział.

Autoryzacja

Skrypty, które korzystają z tej 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 wiele kolumn na podstawie określonego separatora.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametry

NazwaTypOpis
delimiterTextToColumnsDelimiterZdefiniowany separator, według którego ma nastąpić podział.

Autoryzacja

Skrypty, które korzystają z tej 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()

Obcina białe znaki (takie jak spacje, tabulacje czy nowe linie) w każdej komórce w tym zakresie. Usuwa wszystkie odstępy na początku i końcu tekstu w każdej komórce oraz zamienia wszystkie ciągi znaków odstępu na pojedynczą spację.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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 „niezaznaczone”. Ignoruje komórki w zakresie, które nie zawierają skonfigurowanej wartości zaznaczenia lub niezaznaczenia.

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

Powrót

Range – ten zakres do łańcuchowania.

Autoryzacja

Skrypty, które korzystają z tej 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