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

Class Range

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

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`Range`	Ustawia określony zakres jako `active range`, a lewą górną komórkę w zakresie jako `current cell`.
`activateAsCurrentCell()`	`Range`	Ustawia określoną komórkę jako `current cell`.
`addDeveloperMetadata(key)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem.
`addDeveloperMetadata(key, visibility)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem i widocznością.
`addDeveloperMetadata(key, value)`	`Range`	Dodaje do zakresu metadane dewelopera z określonym kluczem i wartością.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Dodaje do zakresu metadane dewelopera o określonym kluczu, wartości i widoczności.
`applyColumnBanding()`	`Banding`	Stosuje do zakresu domyślny motyw pasków kolumn.
`applyColumnBanding(bandingTheme)`	`Banding`	Stosuje do zakresu określony motyw pasków kolumn.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje do zakresu określony motyw pasów kolumn z określonymi ustawieniami nagłówka i stopki.
`applyRowBanding()`	`Banding`	Stosuje do zakresu domyślny motyw naprzemiennego kolorowania wierszy.
`applyRowBanding(bandingTheme)`	`Banding`	Stosuje do zakresu określony motyw paskowania wierszy.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Stosuje do zakresu określony motyw pasków wierszy z określonymi ustawieniami nagłówka i stopki.
`autoFill(destination, series)`	`void`	Wypełnia komórkę `destinationRange` danymi na podstawie danych z tego zakresu.
`autoFillToNeighbor(series)`	`void`	Oblicza zakres, który ma zostać wypełniony nowymi danymi, na podstawie sąsiednich komórek i automatycznie wypełnia ten zakres nowymi wartościami na podstawie danych w nim zawartych.
`breakApart()`	`Range`	Ponownie podzielić wszystkie komórki wielokolumnowe w zakresie na pojedyncze komórki.
`canEdit()`	`Boolean`	Określa, czy użytkownik ma uprawnienia do edytowania każdej komórki w zakresie.
`check()`	`Range`	Zmienia stan pól wyboru w zakresie na „zaznaczone”.
`clear()`	`Range`	Usuwa zakres treści i formatów.
`clear(options)`	`Range`	Czyści zakres zawartości, formatu, reguł sprawdzania poprawności danych lub komentarzy zgodnie z określonymi opcjami zaawansowanymi.
`clearContent()`	`Range`	Czyści zawartość zakresu, pozostawiając formatowanie bez zmian.
`clearDataValidations()`	`Range`	Usuwa reguły sprawdzania poprawności danych z zakresu.
`clearFormat()`	`Range`	Czyści formatowanie w tym zakresie.
`clearNote()`	`Range`	Usuwa notatkę z wybranej komórki lub komórek.
`collapseGroups()`	`Range`	Zwijanie wszystkich grup, które w całości mieszczą się w zakresie.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do podanej lokalizacji.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Skopiuj formatowanie zakresu do podanej lokalizacji.
`copyTo(destination)`	`void`	Kopiuje dane z zakresu komórek do innego zakresu komórek.
`copyTo(destination, copyPasteType, transposed)`	`void`	Kopiuje dane z zakresu komórek do innego zakresu komórek.
`copyTo(destination, options)`	`void`	Kopiuje dane z zakresu komórek do innego zakresu komórek.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Skopiuj zawartość zakresu do podanej lokalizacji.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Skopiuj zawartość zakresu do podanej lokalizacji.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Tworzy pustą tabelę przestawną źródła danych na podstawie źródła danych, zakotwiczoną w pierwszej komórce tego zakresu.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Tworzy pustą tabelę źródła danych na podstawie źródła danych, zakotwiczoną w pierwszej komórce tego zakresu.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca DeveloperMetadataFinderApi do wyszukiwania metadanych dewelopera w zakresie tego zakresu.
`createFilter()`	`Filter`	Tworzy filtr i stosuje go do określonego zakresu w arkuszu.
`createPivotTable(sourceData)`	`PivotTable`	Tworzy pustą tabelę przestawną z określonego zakresu `sourceData` zakotwiczonego w pierwszej komórce tego zakresu.
`createTextFinder(findText)`	`TextFinder`	Tworzy narzędzie do wyszukiwania tekstu w zakresie, które może wyszukiwać i zamieniać tekst w tym zakresie.
`deleteCells(shiftDimension)`	`void`	Usuwa ten zakres komórek.
`expandGroups()`	`Range`	Rozwija zwinięte grupy, których zakres lub przełącznik sterujący przecina ten zakres.
`getA1Notation()`	`String`	Zwraca opis zakresu w formie ciągu znaków w notacji A1.
`getBackground()`	`String`	Zwraca kolor tła lewej górnej komórki w zakresie (np. `'#ffffff'`).
`getBackgroundObject()`	`Color`	Zwraca kolor tła lewej górnej komórki w zakresie.
`getBackgroundObjects()`	`Color[][]`	Zwraca kolory tła komórek w zakresie.
`getBackgrounds()`	`String[][]`	Zwraca kolory tła komórek w zakresie (np. `'#ffffff'`).
`getBandings()`	`Banding[]`	Zwraca wszystkie zakresy, które są stosowane do dowolnych komórek w tym zakresie.
`getCell(row, column)`	`Range`	Zwraca daną komórkę w zakresie.
`getColumn()`	`Integer`	Zwraca pozycję początkową kolumny w tym zakresie.
`getDataRegion()`	`Range`	Zwraca kopię zakresu rozszerzonego w 4 kierunkach głównych `Direction`, aby obejmował wszystkie sąsiednie komórki zawierające dane.
`getDataRegion(dimension)`	`Range`	Zwraca kopię zakresu rozszerzonego o `Direction.UP` i `Direction.DOWN`, jeśli określony wymiar to `Dimension.ROWS`, lub o `Direction.NEXT` i `Direction.PREVIOUS`, jeśli wymiar to `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Zwraca `DataSourceFormula` pierwszej komórki w zakresie lub `null`, jeśli komórka nie zawiera formuły źródła danych.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Zwraca `DataSourceFormula` komórek w zakresie.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródeł danych, które przecinają zakres.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych, które przecinają zakres.
`getDataSourceUrl()`	`String`	Zwraca adres URL danych w tym zakresie, którego można użyć do tworzenia wykresów i zapytań.
`getDataTable()`	`DataTable`	Zwraca dane w tym obiekcie jako DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Zwraca dane z tego zakresu jako DataTable.
`getDataValidation()`	`DataValidation`	Zwraca regułę sprawdzania poprawności danych dla komórki w lewym górnym rogu zakresu.
`getDataValidations()`	`DataValidation[][]`	Zwraca reguły sprawdzania poprawności danych dla wszystkich komórek w zakresie.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Pobiera metadane dewelopera powiązane z tym zakresem.
`getDisplayValue()`	`String`	Zwraca wyświetlaną wartość lewej górnej komórki w zakresie.
`getDisplayValues()`	`String[][]`	Zwraca prostokątną siatkę wartości dla tego zakresu.
`getFilter()`	`Filter`	Zwraca filtr w arkuszu, do którego należy ten zakres, lub `null`, jeśli w arkuszu nie ma filtra.
`getFontColorObject()`	`Color`	Zwraca kolor czcionki komórki w lewym górnym rogu zakresu.
`getFontColorObjects()`	`Color[][]`	Zwraca kolory czcionki komórek w zakresie.
`getFontFamilies()`	`String[][]`	Zwraca rodziny czcionek komórek w zakresie.
`getFontFamily()`	`String`	Zwraca rodzinę czcionek komórki w lewym górnym rogu zakresu.
`getFontLine()`	`String`	Pobiera styl linii komórki w lewym górnym rogu zakresu (`'underline'`, `'line-through'` lub `'none'`).
`getFontLines()`	`String[][]`	Pobiera styl linii komórek w zakresie (`'underline'`, `'line-through'` lub `'none'`).
`getFontSize()`	`Integer`	Zwraca rozmiar czcionki w punktach komórki w lewym górnym rogu zakresu.
`getFontSizes()`	`Integer[][]`	Zwraca rozmiary czcionek komórek w zakresie.
`getFontStyle()`	`String`	Zwraca styl czcionki (`'italic'` lub `'normal'`) komórki w lewym górnym rogu zakresu.
`getFontStyles()`	`String[][]`	Zwraca style czcionki komórek w zakresie.
`getFontWeight()`	`String`	Zwraca grubość czcionki (normalna/pogrubiona) komórki w lewym górnym rogu zakresu.
`getFontWeights()`	`String[][]`	Zwraca wagi czcionek komórek w zakresie.
`getFormula()`	`String`	Zwraca formułę (w notacji A1) dla lewej górnej komórki zakresu lub pusty ciąg znaków, jeśli komórka jest pusta lub nie zawiera formuły.
`getFormulaR1C1()`	`String`	Zwraca formułę (w notacji R1C1) dla danej komórki lub `null`, jeśli nie ma formuły.
`getFormulas()`	`String[][]`	Zwraca formuły (notacja A1) dla komórek w zakresie.
`getFormulasR1C1()`	`String[][]`	Zwraca formuły (notacja R1C1) dla komórek w zakresie.
`getGridId()`	`Integer`	Zwraca identyfikator siatki arkusza nadrzędnego zakresu.
`getHeight()`	`Integer`	Zwraca wysokość zakresu.
`getHorizontalAlignment()`	`String`	Zwraca wyrównanie poziome tekstu (do lewej, do środka lub do prawej) w komórce w lewym górnym rogu zakresu.
`getHorizontalAlignments()`	`String[][]`	Zwraca poziome wyrównanie komórek w zakresie.
`getLastColumn()`	`Integer`	Zwraca pozycję kolumny końcowej.
`getLastRow()`	`Integer`	Zwraca pozycję wiersza końcowego.
`getMergedRanges()`	`Range[]`	Zwraca tablicę obiektów `Range` reprezentujących scalone komórki, które w całości znajdują się w bieżącym zakresie lub zawierają co najmniej 1 komórkę w bieżącym zakresie.
`getNextDataCell(direction)`	`Range`	Zaczynając od komórki w pierwszej kolumnie i wierszu zakresu, zwraca następną komórkę w podanym kierunku, która jest krawędzią ciągłego zakresu komórek zawierających dane lub komórką na krawędzi arkusza kalkulacyjnego w tym kierunku.
`getNote()`	`String`	Zwraca notatkę powiązaną z podanym zakresem.

Class Range Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Class Range