Auf Tabellenbereiche zugreifen und sie ändern. Ein Bereich kann eine einzelne Zelle in einem Tabellenblatt oder eine Gruppe von benachbarten Zellen in einem Blatt.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
activate() | Range | Legt den angegebenen Bereich als active range fest, mit dem oberen
linke Zelle im Bereich als current cell . |
activateAsCurrentCell() | Range | Legt die angegebene Zelle als current cell fest. |
addDeveloperMetadata(key) | Range | Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel hinzu. |
addDeveloperMetadata(key, visibility) | Range | Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzu. |
addDeveloperMetadata(key, value) | Range | Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu. |
addDeveloperMetadata(key, value, visibility) | Range | Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der angegebenen Sichtbarkeit hinzu. |
applyColumnBanding() | Banding | Wendet ein Standarddesign für das Spalten-Banding auf den Bereich an. |
applyColumnBanding(bandingTheme) | Banding | Wendet ein angegebenes Spaltenbanding-Design auf den Bereich an. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Wendet ein festgelegtes Spalten-Banding-Design auf den Bereich mit angegebener Kopf- und Fußzeile an Einstellungen. |
applyRowBanding() | Banding | Wendet ein Standarddesign für das Zeilen-Banding auf den Bereich an. |
applyRowBanding(bandingTheme) | Banding | Wendet ein angegebenes Banding-Design für Zeilen auf den Bereich an. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Wendet ein festgelegtes Zeilen-Banding-Design auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an. |
autoFill(destination, series) | void | Füllt destinationRange mit Daten, die auf den Daten in diesem Bereich basieren. |
autoFillToNeighbor(series) | void | Berechnet basierend auf benachbarten Zellen einen Bereich, der mit neuen Daten gefüllt werden soll, und füllt automatisch Bereich mit neuen Werten basierend auf den Daten in diesem Bereich. |
breakApart() | Range | Teilen Sie alle mehrspaltigen Zellen im Bereich wieder in einzelne Zellen auf. |
canEdit() | Boolean | Legt fest, ob der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten. |
check() | Range | Ändert den Status der Kästchen im Bereich zu „aktiviert“. |
clear() | Range | Löscht den Bereich der Inhalte und Formate. |
clear(options) | Range | Löscht den Inhalt, das Format, die Datenvalidierungsregeln und/oder Kommentare, wie mit die angegebenen erweiterten Optionen. |
clearContent() | Range | Löscht den Inhalt des Bereichs, wobei die Formatierung beibehalten wird. |
clearDataValidations() | Range | Löscht die Datenvalidierungsregeln für den Bereich. |
clearFormat() | Range | Löscht die Formatierung für diesen Bereich. |
clearNote() | Range | Löscht die Notiz in der angegebenen Zelle oder Zellen. |
collapseGroups() | Range | Minimiert alle Gruppen, die vollständig im Bereich enthalten sind. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | Kopieren Sie die Formatierung des Bereichs an die angegebene Position. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | Kopieren Sie die Formatierung des Bereichs an die angegebene Position. |
copyTo(destination) | void | Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. |
copyTo(destination, copyPasteType, transposed) | void | Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. |
copyTo(destination, options) | void | Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | Kopiert den Inhalt des Bereichs an den angegebenen Ort. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Kopiert den Inhalt des Bereichs an den angegebenen Ort. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Erstellt eine leere Datenquellen-Pivot-Tabelle aus der Datenquelle, die an der ersten Zelle in verankert ist Bereich. |
createDataSourceTable(dataSource) | DataSourceTable | Erstellt eine leere Datenquellentabelle aus der Datenquelle, verankert in der ersten Zelle in dieser Bereich. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Gibt eine DeveloperMetadataFinderApi zurück, um Entwicklermetadaten im Bereich dieses Bereich. |
createFilter() | Filter | Erstellt einen Filter und wendet ihn auf den angegebenen Bereich im Tabellenblatt an. |
createPivotTable(sourceData) | PivotTable | Erstellt eine leere Pivot-Tabelle aus dem angegebenen sourceData , der in der ersten Zelle verankert ist
in diesem Bereich. |
createTextFinder(findText) | TextFinder | Erstellt einen Textsucher für den Bereich, mit dem Text in diesem Bereich gesucht und ersetzt werden kann. |
deleteCells(shiftDimension) | void | Löscht diesen Zellenbereich. |
expandGroups() | Range | Maximiert die minimierten Gruppen, deren Bereich oder Steuerelement sich mit diesem Bereich überschneidet. |
getA1Notation() | String | Gibt eine Zeichenfolgenbeschreibung des Bereichs in A1-Schreibweise zurück. |
getBackground() | String | Gibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück (z. B. '#ffffff' ). |
getBackgroundObject() | Color | Gibt die Hintergrundfarbe der linken oberen Zelle im Bereich zurück. |
getBackgroundObjects() | Color[][] | Gibt die Hintergrundfarben der Zellen im Bereich zurück. |
getBackgrounds() | String[][] | Gibt die Hintergrundfarben der Zellen im Bereich zurück (z. B. '#ffffff' ). |
getBandings() | Banding[] | Gibt alle Bandings zurück, die auf beliebige Zellen in diesem Bereich angewendet wurden. |
getCell(row, column) | Range | Gibt eine bestimmte Zelle in einem Bereich zurück. |
getColumn() | Integer | Gibt die Position der Startspalte für diesen Bereich zurück. |
getDataRegion() | Range | Gibt eine Kopie des Bereichs zurück, der in den vier Kardinal-Direction s erweitert wurde, um alle abzudecken
benachbarten Zellen mit Daten. |
getDataRegion(dimension) | Range | Gibt eine Kopie des erweiterten Bereichs Direction.UP und Direction.DOWN zurück, wenn der Wert
angegebene Dimension ist Dimension.ROWS oder Direction.NEXT und Direction.PREVIOUS , wenn die Dimension Dimension.COLUMNS ist. |
getDataSourceFormula() | DataSourceFormula | Gibt die DataSourceFormula für die erste Zelle im Bereich zurück oder null , wenn
Die Zelle enthält keine Datenquellenformel. |
getDataSourceFormulas() | DataSourceFormula[] | Gibt die DataSourceFormula -Werte für die Zellen im Bereich zurück. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Ruft alle Pivot-Tabellen der Datenquelle ab, die sich mit dem Bereich überschneiden. |
getDataSourceTables() | DataSourceTable[] | Ruft alle Datenquellentabellen ab, die sich mit dem Bereich überschneiden. |
getDataSourceUrl() | String | Gibt eine URL für die Daten in diesem Bereich zurück, die zum Erstellen von Diagrammen und Abfragen verwendet werden kann. |
getDataTable() | DataTable | Gibt die Daten in diesem Objekt als DataTable zurück. |
getDataTable(firstRowIsHeader) | DataTable | Gibt die Daten innerhalb dieses Bereichs als DataTable zurück. |
getDataValidation() | DataValidation | Gibt die Datenvalidierungsregel für die linke obere Zelle im Bereich zurück. |
getDataValidations() | DataValidation[][] | Gibt die Datenvalidierungsregeln für alle Zellen im Bereich zurück. |
getDeveloperMetadata() | DeveloperMetadata[] | Ruft die mit diesem Bereich verknüpften Entwicklermetadaten ab. |
getDisplayValue() | String | Gibt den angezeigten Wert der linken oberen Zelle im Bereich zurück. |
getDisplayValues() | String[][] | Gibt das rechteckige Werteraster für diesen Bereich zurück. |
getFilter() | Filter | Gibt den Filter für das Tabellenblatt zurück, zu dem dieser Bereich gehört, oder null , wenn kein Filter vorhanden ist
auf dem Blatt. |
getFontColorObject() | Color | Gibt die Schriftfarbe der Zelle in der linken oberen Ecke des Bereichs zurück. |
getFontColorObjects() | Color[][] | Gibt die Schriftfarben der Zellen im Bereich zurück. |
getFontFamilies() | String[][] | Gibt die Schriftfamilien der Zellen im Bereich zurück. |
getFontFamily() | String | Gibt die Schriftfamilie der Zelle in der linken oberen Ecke des Bereichs zurück. |
getFontLine() | String | Ruft den Linienstil der Zelle in der linken oberen Ecke des Bereichs ab ('underline' ,
'line-through' oder 'none' ). |
getFontLines() | String[][] | Ruft den Linienstil der Zellen im Bereich ('underline' , 'line-through' oder
'none' . |
getFontSize() | Integer | Gibt die Schriftgröße der Zelle in der oberen linken Ecke des Bereichs in Punktgröße zurück. |
getFontSizes() | Integer[][] | Gibt die Schriftgrößen der Zellen im Bereich zurück. |
getFontStyle() | String | Gibt den Schriftstil ('italic' oder 'normal' ) der Zelle links oben zurück
des Bereichs. |
getFontStyles() | String[][] | Gibt die Schriftstile der Zellen im Bereich zurück. |
getFontWeight() | String | Gibt die Schriftstärke (normal/fett) der Zelle in der linken oberen Ecke des Bereichs zurück. |
getFontWeights() | String[][] | Gibt die Schriftstärken der Zellen im Bereich zurück. |
getFormula() | String | Gibt die Formel (A1-Schreibweise) für die linke obere Zelle des Bereichs zurück bzw. eine leere Zeichenfolge, wenn Zelle ist leer oder enthält keine Formel. |
getFormulaR1C1() | String | Gibt die Formel (R1C1-Notation) für eine bestimmte Zelle oder null zurück, wenn keine vorhanden ist. |
getFormulas() | String[][] | Gibt die Formeln für die Zellen im Bereich (A1-Schreibweise) zurück. |
getFormulasR1C1() | String[][] | Gibt die Formeln für die Zellen im Bereich (R1C1-Schreibweise) zurück. |
getGridId() | Integer | Gibt die Raster-ID des übergeordneten Tabellenblatts des Bereichs zurück. |
getHeight() | Integer | Gibt die Höhe des Bereichs zurück. |
getHorizontalAlignment() | String | Gibt die horizontale Ausrichtung des Textes (links/Mitte/rechts) der Zelle links oben zurück des Bereichs. |
getHorizontalAlignments() | String[][] | Gibt die horizontale Ausrichtung der Zellen im Bereich zurück. |
getLastColumn() | Integer | Gibt die Position der Endspalte zurück. |
getLastRow() | Integer | Gibt die Position der Endzeile zurück. |
getMergedRanges() | Range[] | Gibt ein Array von Range -Objekten zurück, die zusammengeführte Zellen darstellen, die entweder vollständig sind
innerhalb des aktuellen Bereichs liegt oder mindestens eine Zelle im aktuellen Bereich enthält. |
getNextDataCell(direction) | Range | Gibt an, beginnend bei der Zelle in der ersten Spalte bzw. Zeile des Bereichs, wird die nächste Zelle in der angegebene Richtung, die den Rand eines zusammenhängenden Zellbereichs mit Daten darstellt am Rand der Tabelle in diese Richtung. |
getNote() | String | Gibt die Notiz zurück, die dem angegebenen Bereich zugeordnet ist. |
getNotes() | String[][] | Gibt die Notizen zurück, die mit den Zellen im Bereich verknüpft sind. |
getNumColumns() | Integer | Gibt die Anzahl der Spalten in diesem Bereich zurück. |
getNumRows() | Integer | Gibt die Anzahl der Zeilen in diesem Bereich zurück. |
getNumberFormat() | String | Rufen Sie die Zahlen- oder Datumsformatierung der linken oberen Zelle des angegebenen Bereichs ab. |
getNumberFormats() | String[][] | Gibt das Zahlen- oder Datumsformat für die Zellen im Bereich zurück. |
getRichTextValue() | RichTextValue | Gibt den Rich-Text-Wert für die linke obere Zelle des Bereichs zurück oder null , wenn die Zelle
"value" ist kein Text. |
getRichTextValues() | RichTextValue[][] | Gibt die Rich-Text-Werte für die Zellen im Bereich zurück. |
getRow() | Integer | Gibt die Zeilenposition für diesen Bereich zurück |
getRowIndex() | Integer | Gibt die Zeilenposition für diesen Bereich zurück |
getSheet() | Sheet | Gibt das Tabellenblatt zurück, zu dem dieser Bereich gehört |
getTextDirection() | TextDirection | Gibt die Textrichtung für die linke obere Zelle des Bereichs zurück. |
getTextDirections() | TextDirection[][] | Gibt die Textrichtung für die Zellen im Bereich zurück. |
getTextRotation() | TextRotation | Gibt die Einstellungen für die Textdrehung für die linke obere Zelle des Bereichs zurück. |
getTextRotations() | TextRotation[][] | Gibt die Einstellungen für die Textdrehung für die Zellen im Bereich zurück. |
getTextStyle() | TextStyle | Gibt den Textstil für die linke obere Zelle des Bereichs zurück. |
getTextStyles() | TextStyle[][] | Gibt die Textstile für die Zellen im Bereich zurück. |
getValue() | Object | Gibt den Wert der linken oberen Zelle im Bereich zurück. |
getValues() | Object[][] | Gibt das rechteckige Werteraster für diesen Bereich zurück. |
getVerticalAlignment() | String | Gibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle in der linken oberen Ecke des Bereich. |
getVerticalAlignments() | String[][] | Gibt die vertikalen Ausrichtungen der Zellen im Bereich zurück. |
getWidth() | Integer | Gibt die Breite des Bereichs in Spalten zurück. |
getWrap() | Boolean | Gibt zurück, ob der Text in der Zelle umgebrochen wird. |
getWrapStrategies() | WrapStrategy[][] | Gibt die Strategien für den Textumbruch für die Zellen im Bereich zurück. |
getWrapStrategy() | WrapStrategy | Gibt die Textumbruchstrategie für die obere linke Zelle des Bereichs zurück |
getWraps() | Boolean[][] | Gibt zurück, ob der Text in den Zellen umgebrochen wird. |
insertCells(shiftDimension) | Range | Fügt leere Zellen in diesen Bereich ein. |
insertCheckboxes() | Range | Fügt Kästchen in jede Zelle im Bereich ein, die mit true für aktivierte und
false für nicht aktiviert. |
insertCheckboxes(checkedValue) | Range | Fügt in jede Zelle des Bereichs Kästchen ein und ist mit einem benutzerdefinierten Wert für aktivierte und der leere Zeichenfolge für deaktiviert. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten Zellen konfiguriert sind. und ungeprüfte Zustände. |
isBlank() | Boolean | Gibt true zurück, wenn der Bereich vollständig leer ist. |
isChecked() | Boolean | Gibt zurück, ob alle Zellen im Bereich den Status "Aktiviert" haben. |
isEndColumnBounded() | Boolean | Bestimmt, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist. |
isEndRowBounded() | Boolean | Bestimmt, ob das Ende des Bereichs an eine bestimmte Zeile gebunden ist. |
isPartOfMerge() | Boolean | Gibt true zurück, wenn sich die Zellen im aktuellen Bereich mit verbundenen Zellen überschneiden. |
isStartColumnBounded() | Boolean | Bestimmt, ob der Anfang des Bereichs an eine bestimmte Spalte gebunden ist. |
isStartRowBounded() | Boolean | Bestimmt, ob der Beginn des Bereichs an eine bestimmte Zeile gebunden ist. |
merge() | Range | Führt die Zellen des Bereichs zu einem Block zusammen. |
mergeAcross() | Range | Verbinden Sie die Zellen des Bereichs über die Spalten des Bereichs hinweg. |
mergeVertically() | Range | Verbindet die Zellen im Bereich miteinander. |
moveTo(target) | void | Schneide aus diesem Bereich aus und füge ihn in den Zielbereich ein (Format und Werte). |
offset(rowOffset, columnOffset) | Range | Gibt einen neuen Bereich zurück, der von diesem Bereich um die angegebene Anzahl von Zeilen und Spalten versetzt ist (der negativ sein kann). |
offset(rowOffset, columnOffset, numRows) | Range | Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen linker oberer Punkt versetzt ist aus dem aktuellen Bereich durch die angegebenen Zeilen und Spalten und mit der angegebenen Höhe in Zellen. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen linker oberer Punkt versetzt ist aus dem aktuellen Bereich aus den angegebenen Zeilen und Spalten und mit der angegebenen Höhe und Breite in Zellen. |
protect() | Protection | Erstellt ein Objekt, das verhindern kann, dass der Bereich bearbeitet wird, außer von Nutzern, die Berechtigung. |
randomize() | Range | Sortiert die Reihenfolge der Zeilen im angegebenen Bereich nach dem Zufallsprinzip. |
removeCheckboxes() | Range | Entfernt alle Kästchen aus dem Bereich. |
removeDuplicates() | Range | Entfernt Zeilen in diesem Bereich, die Duplikate von Werten in beliebigen enthalten. in der vorherigen Zeile. |
removeDuplicates(columnsToCompare) | Range | Entfernt Zeilen in diesem Bereich, die Duplikate in den angegebenen Spalten enthalten. der Werte in der vorherigen Zeile. |
setBackground(color) | Range | Legt die Hintergrundfarbe aller Zellen im Bereich in der CSS-Notation fest (z. B. '#ffffff' )
oder 'white' ). |
setBackgroundObject(color) | Range | Legt die Hintergrundfarbe aller Zellen im Bereich fest. |
setBackgroundObjects(color) | Range | Legt ein rechteckiges Raster mit Hintergrundfarben fest, die den Abmessungen dieses Bereichs entsprechen müssen. |
setBackgroundRGB(red, green, blue) | Range | Legt die gegebene Farbe als Hintergrund mithilfe von RGB-Werten fest (Ganzzahlen von 0 bis einschließlich 255). |
setBackgrounds(color) | Range | Legt ein rechteckiges Raster mit Hintergrundfarben fest, die den Abmessungen dieses Bereichs entsprechen müssen. |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | Legt die Rahmeneigenschaft fest. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | Legt die Rahmeneigenschaft mit Farbe und/oder Stil fest. |
setDataValidation(rule) | Range | Legt eine Datenvalidierungsregel für alle Zellen im Bereich fest. |
setDataValidations(rules) | Range | Legt die Datenvalidierungsregeln für alle Zellen im Bereich fest. |
setFontColor(color) | Range | Legt die Schriftfarbe in der CSS-Notation fest (z. B. '#ffffff' oder 'white' ). |
setFontColorObject(color) | Range | Legt die Schriftfarbe des angegebenen Bereichs fest. |
setFontColorObjects(colors) | Range | Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFontColors(colors) | Range | Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFontFamilies(fontFamilies) | Range | Legt ein rechteckiges Raster mit Schriftfamilien fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFontFamily(fontFamily) | Range | Legt die Schriftfamilie fest, z. B. "Arial" oder "Helvetica". |
setFontLine(fontLine) | Range | Legt den Linienstil der Schriftart des angegebenen Bereichs ('underline' , 'line-through' oder
'none' . |
setFontLines(fontLines) | Range | Legt ein rechteckiges Raster mit Linienstile fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFontSize(size) | Range | Legt die Schriftgröße fest, wobei die Größe die zu verwendende Punktgröße ist. |
setFontSizes(sizes) | Range | Legt ein rechteckiges Raster mit Schriftgrößen fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFontStyle(fontStyle) | Range | Legen Sie den Schriftstil für den angegebenen Bereich fest ('italic' oder 'normal' ). |
setFontStyles(fontStyles) | Range | Legt ein rechteckiges Raster mit Schriftstilen fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFontWeight(fontWeight) | Range | Legen Sie die Schriftstärke für den angegebenen Bereich (normal/fett) fest. |
setFontWeights(fontWeights) | Range | Legt ein rechteckiges Raster mit Schriftstärken fest (muss den Abmessungen dieses Bereichs entsprechen). |
setFormula(formula) | Range | Aktualisiert die Formel für diesen Bereich. |
setFormulaR1C1(formula) | Range | Aktualisiert die Formel für diesen Bereich. |
setFormulas(formulas) | Range | Legt ein rechteckiges Raster mit Formeln fest (muss den Dimensionen dieses Bereichs entsprechen). |
setFormulasR1C1(formulas) | Range | Legt ein rechteckiges Raster mit Formeln fest (muss den Dimensionen dieses Bereichs entsprechen). |
setHorizontalAlignment(alignment) | Range | Legen Sie die horizontale Ausrichtung (von links nach rechts) für den angegebenen Bereich fest (links/mittig/rechts). |
setHorizontalAlignments(alignments) | Range | Legt ein rechteckiges Raster horizontaler Ausrichtungen fest. |
setNote(note) | Range | Setzt die Notiz auf den angegebenen Wert. |
setNotes(notes) | Range | Legt ein rechteckiges Notizenraster fest, das den Abmessungen dieses Bereichs entsprechen muss. |
setNumberFormat(numberFormat) | Range | Legt das Zahlen- oder Datumsformat auf die angegebene Formatierungszeichenfolge fest. |
setNumberFormats(numberFormats) | Range | Legt ein rechteckiges Raster mit Zahlen- oder Datumsformaten fest (muss den Abmessungen dieses Bereichs entsprechen). |
setRichTextValue(value) | Range | Legt den Rich-Text-Wert für die Zellen im Bereich fest. |
setRichTextValues(values) | Range | Legt ein rechteckiges Raster mit Rich-Text-Werten fest. |
setShowHyperlink(showHyperlink) | Range | Legt fest, ob der Bereich Hyperlinks enthalten soll. |
setTextDirection(direction) | Range | Legt die Textrichtung für die Zellen im Bereich fest. |
setTextDirections(directions) | Range | Legt ein rechteckiges Raster mit Wegbeschreibungen fest. |
setTextRotation(degrees) | Range | Legt die Einstellungen für die Textdrehung für die Zellen im Bereich fest. |
setTextRotation(rotation) | Range | Legt die Einstellungen für die Textdrehung für die Zellen im Bereich fest. |
setTextRotations(rotations) | Range | Legt ein rechteckiges Raster mit Textrotationen fest. |
setTextStyle(style) | Range | Legt den Textstil für die Zellen im Bereich fest. |
setTextStyles(styles) | Range | Legt ein rechteckiges Raster mit Textstilen fest. |
setValue(value) | Range | Legt den Wert des Bereichs fest. |
setValues(values) | Range | Legt ein rechteckiges Raster mit Werten fest (muss den Dimensionen dieses Bereichs entsprechen). |
setVerticalAlignment(alignment) | Range | Legen Sie die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich fest (oben/Mitte/unten). |
setVerticalAlignments(alignments) | Range | Legt ein rechteckiges Raster mit vertikalen Ausrichtungen fest, die den Abmessungen dieses Bereichs entsprechen müssen. |
setVerticalText(isVertical) | Range | Legt fest, ob der Text für die Zellen im Bereich gestapelt werden soll. |
setWrap(isWrapEnabled) | Range | Legen Sie den Zellenumbruch für den angegebenen Bereich fest. |
setWrapStrategies(strategies) | Range | Legt ein rechteckiges Raster mit Umbruchstrategien fest. |
setWrapStrategy(strategy) | Range | Legt die Textumbruchstrategie für die Zellen im Bereich fest. |
setWraps(isWrapEnabled) | Range | Legt ein rechteckiges Raster mit Richtlinien für den Zeilenumbruch fest (muss den Abmessungen dieses Bereichs entsprechen). |
shiftColumnGroupDepth(delta) | Range | Ändert die Spaltengruppierungstiefe des Bereichs um den angegebenen Wert. |
shiftRowGroupDepth(delta) | Range | Ändert die Zeilengruppierungstiefe des Bereichs um den angegebenen Wert. |
sort(sortSpecObj) | Range | Sortiert die Zellen im angegebenen Bereich nach der angegebenen Spalte und Reihenfolge. |
splitTextToColumns() | void | Teilt eine Textspalte anhand eines automatisch erkannten Trennzeichens in mehrere Spalten auf. |
splitTextToColumns(delimiter) | void | Teilt eine Textspalte mithilfe der angegebenen Zeichenfolge als benutzerdefiniertes Trennzeichen in mehrere Spalten auf. |
splitTextToColumns(delimiter) | void | Teilt eine Textspalte anhand des angegebenen Trennzeichens in mehrere Spalten auf. |
trimWhitespace() | Range | Passt den Leerraum (z. B. Leerzeichen, Tabulatoren oder neue Zeilen) in allen Zellen in diesem Bereich an. |
uncheck() | Range | Ändert den Status der Kästchen im Bereich zu „Deaktiviert“ |
Detaillierte Dokumentation
activate()
Legt den angegebenen Bereich als active range
fest, mit dem oberen
linke Zelle im Bereich als current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:D10'); range.activate(); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D10 var activeRange = selection.getActiveRange();
Rückflug
Range
: Dieser Bereich für Verkettungen.
activateAsCurrentCell()
Legt die angegebene Zelle als current cell
fest.
Wenn die angegebene Zelle in einem vorhandenen Bereich vorhanden ist, wird dieser Bereich zum aktiven Bereich. die Zelle ist die aktuelle Zelle.
Wenn die angegebene Zelle in keinem vorhandenen Bereich vorhanden ist, ist die vorhandene Auswahl entfernt wird und die Zelle zur aktuellen Zelle und zum aktiven Bereich wird.
Hinweis:Die angegebene Range
muss aus einer Zelle bestehen. Andernfalls wird ein Fehler ausgegeben.
Ausnahme.
// Gets the first sheet of the spreadsheet. var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. var range = sheet.getRange('B5'); var currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel hinzu.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
key | String | Der Schlüssel für die neuen Entwicklermetadaten. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzu.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
key | String | Der Schlüssel für die neuen Entwicklermetadaten. |
visibility | DeveloperMetadataVisibility | Die Sichtbarkeit der neuen Entwicklermetadaten. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
key | String | Der Schlüssel für die neuen Entwicklermetadaten. |
value | String | Der Wert für die neuen Entwicklermetadaten. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der angegebenen Sichtbarkeit hinzu.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
key | String | Der Schlüssel für die neuen Entwicklermetadaten. |
value | String | Der Wert für die neuen Entwicklermetadaten. |
visibility | DeveloperMetadataVisibility | Die Sichtbarkeit der neuen Entwicklermetadaten. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
Wendet ein Standarddesign für das Spalten-Banding auf den Bereich an. Standardmäßig hat das Banding einen Header und keine Farbe der Fußzeile.
// 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());
Rückflug
Banding
— Die neue Banding.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
Wendet ein festgelegtes Spalten-Banding-Design auf den Bereich an. Standardmäßig verfügt das Banding über Header und keine Fußzeilenfarbe.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
bandingTheme | BandingTheme | Ein Farbdesign, das auf die Spalten im Bereich angewendet werden soll. |
Rückflug
Banding
— Die neue Banding.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
Wendet ein festgelegtes Spalten-Banding-Design auf den Bereich mit angegebener Kopf- und Fußzeile an Einstellungen.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
bandingTheme | BandingTheme | Ein Farbdesign, das auf die Spalten im Bereich angewendet werden soll. |
showHeader | Boolean | Bei true wird die Kopfzeilenfarbe des Streifendesigns auf die erste
Spalte. |
showFooter | Boolean | Bei true wird die Fußzeile des Streifendesigns auf die letzte
Spalte. |
Rückflug
Banding
— Die neue Banding.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
Wendet ein Standarddesign für das Zeilen-Banding auf den Bereich an. Standardmäßig hat das Banding einen Header und keine Farbe der Fußzeile.
// 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);
Rückflug
Banding
– Das Banding.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
Wendet ein angegebenes Banding-Design für Zeilen auf den Bereich an. Standardmäßig hat das Banding einen Header und keine Farbe der Fußzeile.
// 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);
Parameter
Name | Typ | Beschreibung |
---|---|---|
bandingTheme | BandingTheme | Ein Farbdesign, das auf die Zeilen im Bereich angewendet werden soll. |
Rückflug
Banding
— Die neue Banding.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
Wendet ein festgelegtes Zeilen-Banding-Design auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an.
// 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);
Parameter
Name | Typ | Beschreibung |
---|---|---|
bandingTheme | BandingTheme | Ein Farbdesign, das auf die Zeilen im Bereich angewendet werden soll. |
showHeader | Boolean | Bei true wird die Kopfzeile des Banding-Designs auf die erste Zeile angewendet. |
showFooter | Boolean | Bei true wird die Fußzeile des Streifendesigns auf die letzte Zeile angewendet. |
Rückflug
Banding
— Die neue Banding.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
Füllt destinationRange
mit Daten, die auf den Daten in diesem Bereich basieren. Die neuen Werte
werden auch durch den angegebenen series
-Typ bestimmt. Der Zielbereich muss Folgendes enthalten:
um diesen Bereich nur in eine Richtung zu erweitern. Beispielsweise wird A1:A20
gefüllt
durch eine Reihe aufsteigender Zahlen basierend auf den aktuellen Werten in A1:A4
:
var sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. var sourceRange = sheet.getRange("A1:A4"); // The range to fill with values. var destination = sheet.getRange("A1:A20"); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Range | Der Bereich, der automatisch mit Werten gefüllt werden soll. Der Zielbereich sollte Bereich enthalten und ihn nur in eine Richtung erweitern (nach oben, unten, links oder rechts). |
series | AutoFillSeries | Der Typ der AutoFill-Reihe, die zur Berechnung neuer Werte verwendet werden soll. Die Der Effekt dieser Reihe variiert je nach Typ und Menge der Quelldaten. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
Berechnet basierend auf benachbarten Zellen einen Bereich, der mit neuen Daten gefüllt werden soll, und füllt automatisch
Bereich mit neuen Werten basierend auf den Daten in diesem Bereich. Diese neuen Werte sind auch
durch den angegebenen series
-Typ festgelegt.
Der berechnete Zielbereich berücksichtigt die umgebenden Daten, um zu ermitteln, wo der neue -Werte sollten eingefügt werden, wenn sich direkt links oder rechts neben einer Spalte, die automatisch ausgefüllt werden, reichen neue Werte nur bis zu den angrenzenden Daten.
Beispiel: A1:A20
wird mit einer Reihe steigender Zahlen gefüllt und diese Methode
wird für den Bereich B1:B4
aufgerufen, der eine Reihe von Datumsangaben enthält, neue Werte werden nur
in B5:B20
eingefügt. Auf diese Weise bleiben diese neuen Werte zu den Zellen hinzu, die
Werte in Spalte A.
var sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] var sourceRange = sheet.getRange("B1:B4"); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Parameter
Name | Typ | Beschreibung |
---|---|---|
series | AutoFillSeries | Der Typ der AutoFill-Reihe, die zur Berechnung neuer Werte verwendet werden soll. Die Der Effekt dieser Reihe variiert je nach Typ und Menge der Quelldaten. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Teilen Sie alle mehrspaltigen Zellen im Bereich wieder in einzelne Zellen auf.
Das Aufrufen dieser Funktion für einen Bereich entspricht dem Auswählen eines Bereichs und Formatieren > Zellen verbinden > Verbindung aufheben.
// 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();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
Legt fest, ob der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten. Die Tabellenkalkulation kann geschützte Bereiche und Tabellenblätter jederzeit bearbeiten.
// 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());
Rückflug
Boolean
: true
, wenn der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten false
sonst.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Ändert den Status der Kästchen im Bereich zu „aktiviert“. Die Zellen im Bereich werden ignoriert. die derzeit weder den aktivierten noch den deaktivierten Wert enthalten.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'checked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Löscht den Bereich der Inhalte und Formate.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Löscht den Inhalt, das Format, die Datenvalidierungsregeln und/oder Kommentare, wie mit die angegebenen erweiterten Optionen. Standardmäßig werden alle Daten gelöscht.
// 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});
Parameter
Name | Typ | Beschreibung |
---|---|---|
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
commentsOnly | Boolean | Gibt an, ob nur die Kommentare gelöscht werden sollen. |
contentsOnly | Boolean | Gibt an, ob nur der Inhalt gelöscht werden soll. |
formatOnly | Boolean | Gibt an, ob nur das Format gelöscht werden soll; dass das Löschen Datenvalidierungsregeln löscht. |
validationsOnly | Boolean | Gibt an, ob nur Datenvalidierungsregeln gelöscht werden sollen. |
skipFilteredRows | Boolean | Gibt an, ob gefilterte Zeilen nicht gelöscht werden sollen. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Löscht den Inhalt des Bereichs, wobei die Formatierung beibehalten wird.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Löscht die Datenvalidierungsregeln für den Bereich.
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Löscht die Formatierung für diesen Bereich.
Dadurch wird die Textformatierung in der Zelle bzw. den Zellen im Bereich gelöscht, jedoch nicht zurückgesetzt. Regeln für die Zahlenformatierung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Löscht die Notiz in der angegebenen Zelle oder Zellen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
Minimiert alle Gruppen, die vollständig im Bereich enthalten sind. Wenn sich keine Gruppe vollständig innerhalb Bereich nicht sichtbar ist, wird die tiefste erweiterte Gruppe, die sich teilweise innerhalb des Bereichs befindet, minimiert.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
Kopieren Sie die Formatierung des Bereichs an die angegebene Position. Wenn das Ziel größer oder kleiner ist als der Quellbereich, wird die Quelle entsprechend wiederholt oder gekürzt. Beachten Sie, dass dies kopiert nur die Formatierung.
Eine ausführliche Beschreibung des Parameters „gridId“ finden Sie unter getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
Parameter
Name | Typ | Beschreibung |
---|---|---|
gridId | Integer | Die eindeutige ID des Tabellenblatts innerhalb der Tabelle, unabhängig von der Position. |
column | Integer | Die erste Spalte des Zielbereichs. |
columnEnd | Integer | Die letzte Spalte des Zielbereichs. |
row | Integer | Die Startzeile des Zielbereichs. |
rowEnd | Integer | Die letzte Zeile des Zielbereichs. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
Kopieren Sie die Formatierung des Bereichs an die angegebene Position. Wenn das Ziel größer oder kleiner ist als der Quellbereich, wird die Quelle entsprechend wiederholt oder gekürzt. Beachten Sie, dass dies kopiert nur die Formatierung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
Parameter
Name | Typ | Beschreibung |
---|---|---|
sheet | Sheet | Das Zieltabellenblatt. |
column | Integer | Die erste Spalte des Zielbereichs. |
columnEnd | Integer | Die letzte Spalte des Zielbereichs. |
row | Integer | Die Startzeile des Zielbereichs. |
rowEnd | Integer | Die letzte Zeile des Zielbereichs. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. Sowohl die Werte als auch die Formatierung kopiert.
// The code below copies the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Range | Zielbereich, in den kopiert werden soll ist nur die Zellenposition links oben relevant. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false);
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Range | Zielbereich, in den kopiert werden soll ist nur die Zellenposition links oben relevant. |
copyPasteType | CopyPasteType | Ein Typ, der angibt, wie die Bereichsinhalte in das Ziel. |
transposed | Boolean | Gibt an, ob der Bereich in der transponierten Ausrichtung eingefügt werden soll. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. Standardmäßig sind sowohl die Werte als Formatierungen kopiert, kann aber mit erweiterten Argumenten überschrieben werden.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Range | Zielbereich, in den kopiert werden soll ist nur die Zellenposition links oben relevant. |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
formatOnly | Boolean | gibt an, dass nur das Format kopiert werden soll |
contentsOnly | Boolean | gibt an, dass nur der Inhalt kopiert werden soll |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
Kopiert den Inhalt des Bereichs an den angegebenen Ort. Wenn das Ziel größer oder kleiner ist als der Quellbereich, wird die Quelle entsprechend wiederholt oder gekürzt.
Eine ausführliche Beschreibung des Parameters „gridId“ finden Sie unter getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
Parameter
Name | Typ | Beschreibung |
---|---|---|
gridId | Integer | Die eindeutige ID des Tabellenblatts innerhalb der Tabelle, unabhängig von der Position. |
column | Integer | Die erste Spalte des Zielbereichs. |
columnEnd | Integer | Die letzte Spalte des Zielbereichs. |
row | Integer | Die Startzeile des Zielbereichs. |
rowEnd | Integer | Die letzte Zeile des Zielbereichs. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
Kopiert den Inhalt des Bereichs an den angegebenen Ort. Wenn das Ziel größer oder kleiner ist als der Quellbereich, wird die Quelle entsprechend wiederholt oder gekürzt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
Parameter
Name | Typ | Beschreibung |
---|---|---|
sheet | Sheet | Das Zieltabellenblatt. |
column | Integer | Die erste Spalte des Zielbereichs. |
columnEnd | Integer | Die letzte Spalte des Zielbereichs. |
row | Integer | Die Startzeile des Zielbereichs. |
rowEnd | Integer | Die letzte Zeile des Zielbereichs. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
Erstellt eine leere Datenquellen-Pivot-Tabelle aus der Datenquelle, die an der ersten Zelle in verankert ist Bereich.
In diesem Beispiel wird gezeigt, wie Sie eine neue Pivot-Tabelle für die Datenquelle erstellen und konfigurieren.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM); pivotTable.addFilter('dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());
Parameter
Name | Typ | Beschreibung |
---|---|---|
dataSource | DataSource | Die Datenquelle, aus der die Pivot-Tabelle erstellt werden soll. |
Rückflug
DataSourcePivotTable
: Die neu erstellte Pivot-Tabelle der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
Erstellt eine leere Datenquellentabelle aus der Datenquelle, verankert in der ersten Zelle in dieser Bereich.
In diesem Beispiel wird gezeigt, wie Sie eine neue Datenquellentabelle erstellen und konfigurieren.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var dataSourceTable = anchorCell.createDataSourceTable(dataSource); .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', /* ascending= *\/ true) .addSortSpec('dataColumnB', /* ascending= *\/ false);
Parameter
Name | Typ | Beschreibung |
---|---|---|
dataSource | DataSource | Die Datenquelle, aus der die Pivot-Tabelle erstellt werden soll. |
Rückflug
DataSourceTable
: Die neu erstellte Datenquellentabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Gibt eine DeveloperMetadataFinderApi zurück, um Entwicklermetadaten im Bereich dieses Bereich. Metadaten fallen nur dann in den Bereich des Bereichs, wenn sie vollständig darin enthalten sind. Bereich. Beispielsweise fallen Metadaten, die mit der Zeile „3:3“ verknüpft sind, nicht in einen Bereich. A1:D5, liegt jedoch im Bereich "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());
Rückflug
DeveloperMetadataFinder
: Eine Entwicklermetadaten-Suche, um nach Metadaten im Bereich dieses Bereichs zu suchen.
createFilter()
Erstellt einen Filter und wendet ihn auf den angegebenen Bereich im Tabellenblatt an. Sie können maximal
einen Filter auf einem Blatt. Mit getFilter()
oder Sheet.getFilter()
können Sie auf den Filter zugreifen und ihn nach dem Erstellen ändern.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { let filter = range.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria); }
Grid
Tabellenblätter erstellen, den Standardtabellentyp.
Rastertabellen sind Tabellenblätter, die nicht mit einer Datenbank verbunden sind. Um andere Filtertypen zu erstellen,
sollten Sie Folgendes beachten:
<ph type="x-smartling-placeholder">- </ph>
- Filter für Pivot-Tabellen mit
PivotTable.addFilter(sourceDataColumn, filterCriteria)
erstellen - Filter für ein Tabellenblatt erstellen, das mit einer Datenbank mit
DataSourceSheet.addFilter(columnName, filterCriteria)
verbunden ist - Filter für eine Pivot-Tabelle erstellen, die mit einer Datenbank über
DataSourcePivotTable.addFilter(columnName, filterCriteria)
verbunden ist
Rückflug
Filter
: Der neue Filter.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
Erstellt eine leere Pivot-Tabelle aus dem angegebenen sourceData
, der in der ersten Zelle verankert ist
in diesem Bereich.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
sourceData | Range | Die Daten, aus denen die Pivot-Tabelle erstellt werden soll. |
Rückflug
PivotTable
: Die neu erstellte PivotTable
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
Erstellt einen Textsucher für den Bereich, mit dem Text in diesem Bereich gesucht und ersetzt werden kann.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // Creates a text finder for the range. var textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = textFinder.replaceWith('cat');
Parameter
Name | Typ | Beschreibung |
---|---|---|
findText | String | Text, nach dem gesucht werden soll |
Rückflug
TextFinder
: Die TextFinder
für den Bereich
deleteCells(shiftDimension)
Löscht diesen Zellenbereich. Vorhandene Daten im Tabellenblatt entlang der angegebenen Dimension werden verschoben in Richtung des gelöschten Bereichs.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
Parameter
Name | Typ | Beschreibung |
---|---|---|
shiftDimension | Dimension | Die Dimension, um die vorhandene Daten verschoben werden sollen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
Maximiert die minimierten Gruppen, deren Bereich oder Steuerelement sich mit diesem Bereich überschneidet. Die Die Position der Ein/Aus-Schaltfläche ist der Index, an dem die Ein/Aus-Schaltfläche angezeigt wird, direkt vor oder nach der Gruppe hinzufügen. Wenn sich mehrere Gruppen am selben Standort befinden, wird die Gruppe der flachen Westen erweitert.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
Gibt eine Zeichenfolgenbeschreibung des Bereichs in A1-Schreibweise zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
Rückflug
String
: Die Stringbeschreibung des Bereichs in A1-Schreibweise.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
Gibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück (z. B. '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
Rückflug
String
: Der Farbcode des Hintergrunds.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
Gibt die Hintergrundfarbe der linken oberen Zelle im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
Rückflug
Color
: Die Hintergrundfarbe der linken oberen Zelle im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
Gibt die Hintergrundfarben der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgroundObjects(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
Rückflug
Color[][]
: Ein zweidimensionales Array von Hintergrundfarben.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
Gibt die Hintergrundfarben der Zellen im Bereich zurück (z. B. '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgrounds(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array der Farbcodes der Hintergründe.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
Gibt alle Bandings zurück, die auf beliebige Zellen in diesem Bereich angewendet wurden.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (let banding of bandings) { console.log(banding.getSecondRowColor()); }
Rückflug
Banding[]
: Alle Banding-Werte, die auf Zellen in diesem Bereich angewendet werden.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
Gibt eine bestimmte Zelle in einem Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 var cell = range.getCell(1, 1); Logger.log(cell.getValue());
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Integer | Die Zeile der Zelle im Verhältnis zum Bereich. |
column | Integer | Die Spalte der Zelle im Verhältnis zum Bereich. |
Rückflug
Range
: Ein Bereich, der eine einzelne Zelle an den angegebenen Koordinaten enthält.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
Gibt die Position der Startspalte für diesen Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
Rückflug
Integer
: Die Startspaltenposition des Bereichs in der Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
Gibt eine Kopie des Bereichs zurück, der in den vier Kardinal-Direction
s erweitert wurde, um alle abzudecken
benachbarten Zellen mit Daten. Wenn der Bereich von leeren Zellen umgeben ist, die diese nicht enthalten
entlang der Diagonalen wird der Bereich selbst zurückgegeben. Dies ähnelt der Auswahl des Bereichs und
Geben Sie Ctrl+A
in den Editor ein.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());
Rückflug
Range
: Der Datenbereich des Bereichs oder ein Bereich für die gesamte Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
Gibt eine Kopie des erweiterten Bereichs Direction.UP
und Direction.DOWN
zurück, wenn der Wert
angegebene Dimension ist Dimension.ROWS
oder Direction.NEXT
und Direction.PREVIOUS
, wenn die Dimension Dimension.COLUMNS
ist. Die Erweiterung des Bereichs
basiert auf der Erkennung von Daten neben dem Bereich, der wie eine Tabelle organisiert ist. Der erweiterte Bereich
deckt alle angrenzenden Zellen mit Daten entlang der angegebenen Dimension ab, einschließlich der Tabelle
grenzen. Wenn der ursprüngliche Bereich entlang der angegebenen Abmessung von leeren Zellen umgeben ist,
wird der Bereich selbst zurückgegeben. Diese Methode ähnelt der Auswahl des Bereichs und der Eingabe von
Ctrl+Space
für Spalten oder Shift+Space
für Zeilen im Editor.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "C2:C4" Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation()); // Logs "B3:D3" Logger.log( sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());
Parameter
Name | Typ | Beschreibung |
---|---|---|
dimension | Dimension | Die Dimension, um die der Bereich erweitert werden soll. |
Rückflug
Range
: Der Datenbereich des Bereichs oder ein Bereich, der jede Spalte oder jede Zeile innerhalb des
des ursprünglichen Bereichs.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
Gibt die DataSourceFormula
für die erste Zelle im Bereich zurück oder null
, wenn
Die Zelle enthält keine Datenquellenformel.
// 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);
Rückflug
DataSourceFormula
: Die DataSourceFormula
für die Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Gibt die DataSourceFormula
-Werte für die Zellen im Bereich zurück.
// 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());
Rückflug
DataSourceFormula[]
: Ein Array von DataSourceFormula
-Werten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Ruft alle Pivot-Tabellen der Datenquelle ab, die sich mit dem Bereich überschneiden.
// 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());
Rückflug
DataSourcePivotTable[]
: Eine Liste der Pivot-Tabellen der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Ruft alle Datenquellentabellen ab, die sich mit dem Bereich überschneiden.
// 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());
Rückflug
DataSourceTable[]
: Eine Liste der Datenquellentabellen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
Gibt eine URL für die Daten in diesem Bereich zurück, die zum Erstellen von Diagrammen und Abfragen verwendet werden kann.
Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
Rückflug
String
: Eine URL für diesen Bereich als Datenquelle, die an andere APIs wie Diagramme übergeben werden kann.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
Gibt die Daten in diesem Objekt als DataTable zurück.
// 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();
Rückflug
DataTable
: Die Daten als Datentabelle.
getDataTable(firstRowIsHeader)
Gibt die Daten innerhalb dieses Bereichs als DataTable zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B7"); // Calling this method with "true" sets the first line to be the title of the axes var datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. var chart = Charts.newBarChart() .setDataTable(datatable) .setOption("title", "Your Title Here") .build();
Parameter
Name | Typ | Beschreibung |
---|---|---|
firstRowIsHeader | Boolean | Gibt an, ob die erste Zeile als Kopfzeile behandelt werden soll. |
Rückflug
DataTable
: Die Daten als Datentabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
Gibt die Datenvalidierungsregel für die linke obere Zelle im Bereich zurück. Wenn die Datenvalidierung nicht
festgelegt wurde, gibt diese Methode null
zurück.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
Rückflug
DataValidation
: Die Datenvalidierungsregel für die linke obere Zelle im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
Gibt die Datenvalidierungsregeln für alle Zellen im Bereich zurück. Wenn die Datenvalidierung nicht
festgelegt ist, gibt diese Methode null
für die Position dieser Zelle im Array zurück.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
Rückflug
DataValidation[][]
: Ein zweidimensionales Array von Datenvalidierungsregeln, die den Zellen in der
Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Ruft die mit diesem Bereich verknüpften Entwicklermetadaten ab.
// 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()}`); }
Rückflug
DeveloperMetadata[]
: Die mit diesem Bereich verknüpften Entwicklermetadaten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
Gibt den angezeigten Wert der linken oberen Zelle im Bereich zurück. Der Wert ist ein String
.
Der angezeigte Wert berücksichtigt die Formatierung von Datum, Uhrzeit und Währung, einschließlich
Formate, die automatisch durch die Spracheinstellung der Tabelle angewendet werden. Für leere Zellen
.
// 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());
Rückflug
String
: Der in dieser Zelle angezeigte Wert.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
Gibt das rechteckige Werteraster für diesen Bereich zurück.
Gibt ein zweidimensionales Array von angezeigten Werten zurück, das nach Zeile und dann nach Spalte indexiert wird. Die
Werte sind String
-Objekte. Der angezeigte Wert berücksichtigt Datum, Uhrzeit und
Währungsformatierung, einschließlich Formaten, die automatisch von der Sprache der Tabelle angewendet werden
Einstellung. Leere Zellen werden im Array durch einen leeren String dargestellt. Denken Sie daran: Während ein
Bereichsindex beginnt bei 1, 1
, das JavaScript-Array ist ab [0][0]
indexiert.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
Rückflug
String[][]
: Ein zweidimensionales Array von Werten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Gibt den Filter für das Tabellenblatt zurück, zu dem dieser Bereich gehört, oder null
, wenn kein Filter vorhanden ist
auf dem Blatt.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Gets the existing filter on the sheet that the given range belongs to. let filter = range.getFilter();
Rückflug
Filter
: Der Filter.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
Gibt die Schriftfarbe der Zelle in der linken oberen Ecke des Bereichs zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
Rückflug
Color
: Die Schriftfarbe der linken oberen Zelle im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
Gibt die Schriftfarben der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontColorObjects(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
Rückflug
Color[][]
: Ein zweidimensionales Array der Schriftfarben, die den Zellen im Bereich zugeordnet sind.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
Gibt die Schriftfamilien der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontFamilies(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Schriftfamilien, die den Zellen im Bereich zugeordnet sind.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamily()
Gibt die Schriftfamilie der Zelle in der linken oberen Ecke des Bereichs zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontFamily());
Rückflug
String
: Die Schriftfamilie der Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
Ruft den Linienstil der Zelle in der linken oberen Ecke des Bereichs ab ('underline'
,
'line-through'
oder 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontLine());
Rückflug
String
: Die Schriftlinie.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
Ruft den Linienstil der Zellen im Bereich ('underline'
, 'line-through'
oder
'none'
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontLines(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Schriftlinien, die mit den Zellen im Bereich verknüpft sind.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
Gibt die Schriftgröße der Zelle links oben im Bereich in Punktgröße zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontSize());
Rückflug
Integer
: Die Schriftgröße in Punktgröße.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSizes()
Gibt die Schriftgrößen der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontSizes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
Integer[][]
: Ein zweidimensionales Array von Schriftgrößen von Text, der den Zellen im Bereich zugeordnet ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyle()
Gibt den Schriftstil ('italic'
oder 'normal'
) der Zelle links oben zurück
des Bereichs.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
Rückflug
String
: Der Schriftstil des Textes in der Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyles()
Gibt die Schriftstile der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontStyles(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Schriftstilen für Text, der den Zellen im Bereich zugeordnet ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeight()
Gibt die Schriftstärke (normal/fett) der Zelle in der linken oberen Ecke des Bereichs zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontWeight());
Rückflug
String
: Die Schriftstärke des Textes in der Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeights()
Gibt die Schriftstärken der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontWeights(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array der Schriftstärken von Text, der mit den Zellen im Bereich verknüpft ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
Gibt die Formel (A1-Schreibweise) für die linke obere Zelle des Bereichs zurück bzw. eine leere Zeichenfolge, wenn Zelle ist leer oder enthält keine Formel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 var range = sheet.getRange("B5"); // Logs the calculated value and the formula Logger.log("Calculated value: %s Formula: %s", range.getValue(), range.getFormula());
Rückflug
String
– Die Formel für die Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulaR1C1()
Gibt die Formel (R1C1-Notation) für eine bestimmte Zelle oder null
zurück, wenn keine vorhanden ist.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5"); var formula = range.getFormulaR1C1(); Logger.log(formula);
Rückflug
String
: Die Formel in R1C1-Notation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulas()
Gibt die Formeln für die Zellen im Bereich (A1-Schreibweise) zurück. Einträge im 2D-Array sind leere Zeichenfolgen für Zellen ohne Formel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulas(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Formeln im Stringformat.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulasR1C1()
Gibt die Formeln für die Zellen im Bereich (R1C1-Schreibweise) zurück. Einträge im 2D-Array sind
null
für Zellen ohne Formel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulasR1C1(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Formeln in R1C1-Schreibweise.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGridId()
Gibt die Raster-ID des übergeordneten Tabellenblatts des Bereichs zurück. IDs sind zufällige nicht negative Ganzzahlwerte.
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getGridId());
Rückflug
Integer
: Die Raster-ID des übergeordneten Tabellenblatts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Gibt die Höhe des Bereichs zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // logs 3.0 Logger.log(range.getHeight());
Rückflug
Integer
: Höhe des Bereichs.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignment()
Gibt die horizontale Ausrichtung des Textes (links/Mitte/rechts) der Zelle links oben zurück des Bereichs.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
Rückflug
String
: Die horizontale Ausrichtung des Textes in der Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
Gibt die horizontale Ausrichtung der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getHorizontalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array horizontaler Textausrichtungen, die mit den Zellen im Element verknüpft sind.
Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Gibt die Position der Endspalte zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastColumn());
Rückflug
Integer
: Die Position der letzten Spalte des Bereichs in der Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Gibt die Position der Endzeile zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
Rückflug
Integer
: Die letzte Zeilenposition des Bereichs in der Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
Gibt ein Array von Range
-Objekten zurück, die zusammengeführte Zellen darstellen, die entweder vollständig
innerhalb des aktuellen Bereichs liegt oder mindestens eine Zelle im aktuellen Bereich enthält.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); var mergedRanges = range.getMergedRanges(); for (var i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
Rückflug
Range[]
: Ein Array von Range
-Objekten, die zusammengeführte Zellen darstellen, die den Bereich überlappen.
getNextDataCell(direction)
Gibt an, beginnend bei der Zelle in der ersten Spalte bzw. Zeile des Bereichs, wird die nächste Zelle in der
angegebene Richtung, die den Rand eines zusammenhängenden Zellbereichs mit Daten darstellt
am Rand der Tabelle in diese Richtung. Dies entspricht der Eingabe von
Ctrl+[arrow key]
im Editor.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("C3:E5"); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
Parameter
Name | Typ | Beschreibung |
---|---|---|
direction | Direction | Die Richtung, in der die nächste Datenbereich-Randzelle gefunden werden soll. |
Rückflug
Range
: Die Zelle für den Datenbereich oder die Zelle am Rand der Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNote()
Gibt die Notiz zurück, die dem angegebenen Bereich zugeordnet ist.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getNote());
Rückflug
String
: Die mit der angegebenen Zelle verknüpfte Notiz.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNotes()
Gibt die Notizen zurück, die mit den Zellen im Bereich verknüpft sind.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getNotes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Notizen, die mit den Zellen im Bereich verknüpft sind.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
Gibt die Anzahl der Spalten in diesem Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
Rückflug
Integer
: Die Anzahl der Spalten in diesem Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumRows()
Gibt die Anzahl der Zeilen in diesem Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumRows());
Rückflug
Integer
: Die Anzahl der Zeilen in diesem Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormat()
Rufen Sie die Zahlen- oder Datumsformatierung der linken oberen Zelle des angegebenen Bereichs ab. Das zurückgegebene Format -Muster werden in der Sheets API beschrieben Dokumentation.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
Rückflug
String
: Das Zahlenformat der linken oberen Zelle des Bereichs.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
Gibt das Zahlen- oder Datumsformat für die Zellen im Bereich zurück. Die zurückgegebenen Formatmuster sind Sheets API-Dokumentation beschrieben.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formats = range.getNumberFormats(); for (var i in formats) { for (var j in formats[i]) { Logger.log(formats[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array von Zahlenformaten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
Gibt den Rich-Text-Wert für die linke obere Zelle des Bereichs zurück oder null
, wenn die Zelle
"value" ist kein Text.
// Gets the Rich Text value of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var richText = range.getRichTextValue(); console.log(richText.getText());
Rückflug
RichTextValue
: Der Rich-Text-Wert der oberen linken Zelle im Bereich oder null
, wenn die Zelle
"value" ist kein Text.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
Gibt die Rich-Text-Werte für die Zellen im Bereich zurück.
// Gets the Rich Text values for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var values = range.getRichTextValues(); for (var i = 0; i < values.length; i++) { for (var j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
Rückflug
RichTextValue[][]
: Ein zweidimensionales Array von Rich-Text-Werten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
Gibt die Zeilenposition für diesen Bereich zurück. Identisch mit getRowIndex().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
Rückflug
Integer
: Die Zeilenposition des Bereichs.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
Gibt die Zeilenposition für diesen Bereich zurück. Identisch mit getRow().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
Rückflug
Integer
: Die Zeilenposition des Bereichs.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
getSheet()
Gibt das Tabellenblatt zurück, zu dem dieser Bereich gehört
// 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());
Rückflug
Sheet
: Das Tabellenblatt, zu dem dieser Bereich gehört.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
Gibt die Textrichtung für die linke obere Zelle des Bereichs zurück. Gibt null
zurück, wenn die Zelle
Textrichtung wird durch die automatische Erkennung bestimmt.
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
Rückflug
TextDirection
: Textrichtung der oberen linken Zelle im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
Gibt die Textrichtung für die Zellen im Bereich zurück. Einträge im 2D-Array sind null
für Zellen, die die automatische Erkennung verwenden.
// Get the text directions for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var directions = range.getTextDirections(); for (var i = 0; i < directions.length; i++) { for (var j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
Rückflug
TextDirection[][]
: Ein zweidimensionales Array von Textrichtungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
Gibt die Einstellungen für die Textdrehung für die linke obere Zelle des Bereichs zurück.
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
Rückflug
TextRotation
: Die Einstellungen für die Textrotation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
Gibt die Einstellungen für die Textdrehung für die Zellen im Bereich zurück.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var results = range.getTextRotations(); for (var i in results) { for (var j in results[i]) { var rotation = results[i][j]; Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation); } }
Rückflug
TextRotation[][]
: Ein zweidimensionales Array von Textrotationen, die den Zellen im Bereich zugeordnet sind.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
Gibt den Textstil für die linke obere Zelle des Bereichs zurück.
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
Rückflug
TextStyle
: Der Textstil der linken oberen Zelle im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
Gibt die Textstile für die Zellen im Bereich zurück.
// Get the text styles for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var styles = range.getTextStyles(); for (var i = 0; i < styles.length; i++) { for (var j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
Rückflug
TextStyle[][]
: Ein zweidimensionales Array von Textstilen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
Gibt den Wert der linken oberen Zelle im Bereich zurück. Der Wert kann vom Typ Number
sein,
Boolean
, Date
oder String
, je nach Wert der Zelle. Leer
eine leere Zeichenfolge zurückgeben.
// 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());
Rückflug
Object
: Der Wert in dieser Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
Gibt das rechteckige Werteraster für diesen Bereich zurück.
Gibt ein zweidimensionales Array von Werten zurück, das nach Zeile und dann nach Spalte indexiert wird. Die Werte können
vom Typ Number
, Boolean
, Date
oder String
, je nachdem,
Wert der Zelle. Leere Zellen werden im Array durch einen leeren String dargestellt. Denken Sie daran:
Während ein Bereichsindex bei 1, 1
beginnt, ist das JavaScript-Array ab [0][0]
indexiert.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);
Date
kein zulässiger Parameter. getValues()
kann nicht zurückgegeben werden
an eine Web-App senden, wenn der Bereich eine Zelle mit einem Date
-Wert enthält. Transformieren Sie stattdessen
alle aus dem Tabellenblatt abgerufenen Werte in ein unterstütztes JavaScript-Primitive wie Number
, Boolean
oder String
.Rückflug
Object[][]
: Ein zweidimensionales Array von Werten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
Gibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle in der linken oberen Ecke des Bereich.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
Rückflug
String
: vertikale Ausrichtung des Textes in der Zelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
Gibt die vertikalen Ausrichtungen der Zellen im Bereich zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Rückflug
String[][]
: Ein zweidimensionales Array vertikaler Textausrichtungen, die mit den Zellen im Element verknüpft sind
Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Gibt die Breite des Bereichs in Spalten zurück.
// 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());
Rückflug
Integer
: Die Anzahl der Spalten im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
Gibt zurück, ob der Text in der Zelle umgebrochen wird. Eine detailliertere Umbruchstrategie erhalten Sie mit getWrapStrategy()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
Rückflug
Boolean
: Gibt an, ob der Text in dieser Zelle umgebrochen wird oder nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
Gibt die Strategien für den Textumbruch für die Zellen im Bereich zurück.
// Get the text wrapping strategies for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var strategies = range.getWrapStrategies(); for (var i = 0; i < strategies.length; i++) { for (var j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
Rückflug
WrapStrategy[][]
: Ein zweidimensionales Array von Strategien für den Textumbruch.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
Gibt die Textumbruchstrategie für die obere linke Zelle des Bereichs zurück
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
Rückflug
WrapStrategy
: Die Textumbruchstrategie der oberen linken Zelle im Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
Gibt zurück, ob der Text in den Zellen umgebrochen wird. Eine detailliertere Umbruchstrategie erhalten Sie mit getWrapStrategies()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { var isWrapped = results[i][j]; if (isWrapped) { Logger.log("Cell [%s, %s] has wrapped text", i, j); } } }
Rückflug
Boolean[][]
: Ein zweidimensionales Array vertikaler Textausrichtungen, die mit den Zellen im Element verknüpft sind
Bereich.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
Fügt leere Zellen in diesen Bereich ein. Die neuen Zellen behalten alle Formatierungen in den Zellen bei. die diesen Bereich betrafen. Vorhandene Daten im Tabellenblatt entlang der angegebenen Dimension werden nicht aus dem eingefügten Bereich entfernt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
Parameter
Name | Typ | Beschreibung |
---|---|---|
shiftDimension | Dimension | Die Dimension, um die vorhandene Daten verschoben werden sollen. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
Fügt Kästchen in jede Zelle im Bereich ein, die mit true
für aktivierte und
false
für nicht aktiviert. Legt den Wert aller Zellen im Bereich auf false
fest.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'. range.insertCheckboxes();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Fügt in jede Zelle im Bereich Kästchen ein, die mit einem benutzerdefinierten Wert für aktivierte und der leere Zeichenfolge für deaktiviert. Legt den Wert jeder Zelle im Bereich als leeren String fest.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to // the empty string. range.insertCheckboxes('yes');
Parameter
Name | Typ | Beschreibung |
---|---|---|
checkedValue | Object | Der geprüfte Wert für die Datenvalidierung des Kästchens. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten Zellen konfiguriert sind. und ungeprüfte Zustände. Legt für den Wert jeder Zelle im Bereich den benutzerdefinierten, deaktivierten Wert fest.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'. range.insertCheckboxes('yes', 'no');
Parameter
Name | Typ | Beschreibung |
---|---|---|
checkedValue | Object | Der geprüfte Wert für die Datenvalidierung des Kästchens. |
uncheckedValue | Object | Der deaktivierte Wert für die Datenvalidierung des Kästchens. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isBlank()
Gibt true
zurück, wenn der Bereich vollständig leer ist.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.isBlank());
Rückflug
Boolean
: true
, wenn der Bereich leer ist. Andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
Gibt zurück, ob alle Zellen im Bereich den Status "Aktiviert" haben. Gibt null
zurück, wenn einige Zellen aktiviert und für andere deaktiviert sind oder wenn für einige Zellen kein Kästchen vorhanden ist
der Datenvalidierung.
var range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. var isRange1Checked = range1.isChecked(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked value. var isRange2Checked = range2.isChecked(); var range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox value. var isRange3Checked = range3.isChecked();
Rückflug
Boolean
: true
, wenn alle Zellen im Bereich ausgewählt sind, false
, wenn alle Zellen im
Zellenbereich deaktiviert ist, oder null
, wenn eine der Zellen nicht markiert ist oder keine Zellen enthält,
„Datenvalidierung“ an.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
Bestimmt, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist. Für das Feld
A1:B10
oder B:B
, die an Spalten am Ende des Bereichs gebunden sind,
gibt true
zurück. für die Bereiche 3:7
oder A1:5
, die nur gebunden sind
bestimmte Zeilen am Ende des Bereichs hinzufügen, gibt diese Methode false
zurück.
// 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());
Rückflug
Boolean
: true
, wenn das Ende des Bereichs an eine bestimmte Spalte gebunden ist. false
sonst.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndRowBounded()
Bestimmt, ob das Ende des Bereichs an eine bestimmte Zeile gebunden ist. Für das Feld
A1:B10
oder 3:7
, die an Zeilen am Ende des Bereichs gebunden sind,
gibt true
zurück. für die Bereiche B:B
oder A1:C
, die nur gebunden sind
bestimmte Spalten am Ende des Bereichs hinzugefügt, gibt diese Methode false
zurück.
// 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());
Rückflug
Boolean
: true
, wenn das Ende des Bereichs an eine bestimmte Zeile gebunden ist. false
sonst.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isPartOfMerge()
Gibt true
zurück, wenn sich die Zellen im aktuellen Bereich mit verbundenen Zellen überschneiden.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); // True if any of the cells in A1:B3 is included in a merge. var isPartOfMerge = range.isPartOfMerge();
Rückflug
Boolean
: true
, wenn sich der Bereich mit verbundenen Zellen überschneidet. Andernfalls wird false
zurückgegeben.
isStartColumnBounded()
Bestimmt, ob der Anfang des Bereichs an eine bestimmte Spalte gebunden ist. Für das Feld
Bereiche A1:B10
oder B:B
, die an Spalten zu Beginn des Bereichs gebunden sind,
Diese Methode gibt true
zurück. für den Bereich 3:7
, der nur an eine Zeile bei
dem Beginn des Bereichs ist, gibt diese Methode false
zurück.
// 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());
Rückflug
Boolean
: true
, wenn der Anfang des Bereichs an eine bestimmte Spalte gebunden ist; false
sonst.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isStartRowBounded()
Bestimmt, ob der Beginn des Bereichs an eine bestimmte Zeile gebunden ist. Für das Feld
A1:B10
oder 3:7
, die an Zeilen zu Beginn des Bereichs gebunden sind,
gibt true
zurück. für den Bereich B:B
, der nur an eine bestimmte
am Anfang des Bereichs enthält, gibt diese Methode false
zurück.
// 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());
Rückflug
Boolean
: true
, wenn der Anfang des Bereichs an eine bestimmte Zeile gebunden ist; false
sonst.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
Führt die Zellen des Bereichs zu einem Block zusammen.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below 2-dimensionally merges the cells in A1 to B3 sheet.getRange('A1:B3').merge();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeAcross()
Verbinden Sie die Zellen des Bereichs über die Spalten des Bereichs hinweg.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The code below merges cells C5:E5 into one cell var range1 = sheet.getRange("C5:E5"); range1.mergeAcross(); // The code below creates 2 horizontal cells, F5:H5 and F6:H6 var range2 = sheet.getRange("F5:H6"); range2.mergeAcross();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeVertically()
Verbindet die Zellen im Bereich miteinander.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below vertically merges the cells in A1 to A10 sheet.getRange('A1:A10').mergeVertically(); // The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10 sheet.getRange('B1:D10').mergeVertically();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveTo(target)
Schneide aus diesem Bereich aus und füge ihn in den Zielbereich ein (Format und Werte).
// The code below moves the first 5 columns over to the 6th column var sheet = SpreadsheetApp.getActiveSheet() sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));
Parameter
Name | Typ | Beschreibung |
---|---|---|
target | Range | Einen Zielbereich, in den dieser Bereich kopiert werden soll; nur die Zellenposition oben links relevant sind. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
Gibt einen neuen Bereich zurück, der von diesem Bereich um die angegebene Anzahl von Zeilen und Spalten versetzt ist (der negativ sein kann). Der neue Bereich hat dieselbe Größe wie der ursprüngliche Bereich.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2 var newCell = cell.offset(1, 1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowOffset | Integer | Die Anzahl der Zeilen abwärts von der oberen linken Zelle des Bereichs; negative Werte die Zeilen ausgehend von der oberen linken Zelle des Bereichs darstellen. |
columnOffset | Integer | Die Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. negative Werte Spalten links von der oberen linken Zelle des Bereichs darstellen. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
offset(rowOffset, columnOffset, numRows)
Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen linker oberer Punkt versetzt ist aus dem aktuellen Bereich durch die angegebenen Zeilen und Spalten und mit der angegebenen Höhe in Zellen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:B3 var newRange = cell.offset(1, 1, 2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowOffset | Integer | Die Anzahl der Zeilen abwärts von der oberen linken Zelle des Bereichs; negative Werte die Zeilen ausgehend von der oberen linken Zelle des Bereichs darstellen. |
columnOffset | Integer | Die Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. negative Werte Spalten links von der oberen linken Zelle des Bereichs darstellen. |
numRows | Integer | Die Höhe in Zeilen des neuen Bereichs. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
offset(rowOffset, columnOffset, numRows, numColumns)
Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen linker oberer Punkt versetzt ist aus dem aktuellen Bereich durch die angegebenen Zeilen und Spalten und mit der angegebenen Höhe und Breite in Zellen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:C3 var newRange = cell.offset(1, 1, 2, 2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowOffset | Integer | Die Anzahl der Zeilen abwärts von der oberen linken Zelle des Bereichs; negative Werte die Zeilen ausgehend von der oberen linken Zelle des Bereichs darstellen. |
columnOffset | Integer | Die Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. negative Werte Spalten links von der oberen linken Zelle des Bereichs darstellen. |
numRows | Integer | Die Höhe in Zeilen des neuen Bereichs. |
numColumns | Integer | Die Spaltenbreite des neuen Bereichs. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
protect()
Erstellt ein Objekt, das verhindern kann, dass der Bereich bearbeitet wird, außer von Nutzern, die
Berechtigung. Bis das Skript die Liste der Bearbeiter für den Bereich ändert (durch Aufrufen
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
oder es wird ein neuer
für Protection.setDomainEdit(editable)
), entsprechen die Berechtigungen denen der
Tabelle selbst, was bedeutet, dass der Bereich ungeschützt bleibt. Wenn der Bereich
bereits geschützt ist, wird mit dieser Methode ein neuer geschützter Bereich erstellt, der sich mit dem vorhandenen überschneidet. Wenn
kann eine Zelle durch mehrere geschützte Bereiche geschützt sein und verhindert, dass ein bestimmter Nutzer
kann dieser Nutzer die Zelle nicht bearbeiten.
// Protect range A1:B10, then remove all other users from the list of editors. var ss = SpreadsheetApp.getActive(); var range = ss.getRange('A1:B10'); var protection = range.protect().setDescription('Sample protected range'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Rückflug
Protection
: Ein Objekt, das die Schutzeinstellungen darstellt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
Sortiert die Reihenfolge der Zeilen im angegebenen Bereich nach dem Zufallsprinzip.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Randomizes the range range.randomize();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
Entfernt alle Kästchen aus dem Bereich. Löscht die Datenvalidierung jeder Zelle und Außerdem wird der Wert gelöscht, falls die Zelle entweder den aktivierten oder den deaktivierten Wert enthält.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Removes the checkbox data validation in cell A1 and clears its value. range1.removeCheckboxes(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('random'); // Removes the checkbox data validation in cell A2 but does not clear its value. range2.removeCheckboxes();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates()
Entfernt Zeilen in diesem Bereich, die Duplikate von Werten in beliebigen enthalten. in der vorherigen Zeile. Zeilen mit identischen Werten, aber unterschiedlicher Groß- und Kleinschreibung, Formatierung oder Formeln werden als Duplikate betrachtet. Mit dieser Methode werden auch doppelte Zeilen entfernt, die aus der Ansicht ausgeblendet sind (für z. B. aufgrund eines Filters). Inhalte außerhalb dieses Bereichs werden nicht entfernt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove duplicate rows in the range. range.removeDuplicates();
Rückflug
Range
: Der sich ergebende Bereich nach dem Entfernen von Duplikaten. Die Größe des Bereichs wird um einen
Zeile für jede entfernte Zeile.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates(columnsToCompare)
Entfernt Zeilen in diesem Bereich, die Duplikate in den angegebenen Spalten enthalten. der Werte in der vorherigen Zeile. Zeilen mit identischen Werten, aber unterschiedlicher Groß- und Kleinschreibung, oder Formeln als Duplikate angesehen werden. Bei dieser Methode werden auch ausgeblendete doppelte Zeilen entfernt (z. B. aufgrund eines Filters) aus der Datenansicht. Inhalte außerhalb dieses Bereichs werden nicht entfernt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove rows which have duplicate values in column B. range.removeDuplicates([2]); // Remove rows which have duplicate values in both columns B and D. range.removeDuplicates([2,4]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnsToCompare | Integer[] | Die Spalten, die auf doppelte Werte analysiert werden sollen. Wenn keine Spalten angegeben werden werden alle Spalten auf Duplikate analysiert. |
Rückflug
Range
: Der sich ergebende Bereich nach dem Entfernen von Duplikaten. Die Größe des Bereichs wird um einen
Zeile für jede entfernte Zeile.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Legt die Hintergrundfarbe aller Zellen im Bereich in der CSS-Notation fest (z. B. '#ffffff'
)
oder 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); range.setBackground("red");
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | String | Einen Farbcode in CSS-Notation (z. B. '#ffffff' oder 'white' ) eine
Mit dem Wert null wird die Farbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObject(color)
Legt die Hintergrundfarbe aller Zellen im Bereich fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var bgColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var range = sheet.getRange("B2:D5"); range.setBackgroundObject(bgColor);
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | Color | Die festzulegende Hintergrundfarbe Mit dem Wert „null “ wird die Hintergrundfarbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObjects(color)
Legt ein rechteckiges Raster mit Hintergrundfarben fest, die den Abmessungen dieses Bereichs entsprechen müssen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setBackgroundObjects(colors);
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | Color[][] | Zweidimensionales Array von Farben Mit null -Werten wird die Farbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Setzt den Hintergrund auf die angegebene Farbe mithilfe von RGB-Werten (Ganzzahlen zwischen 0 und 255 einschließlich).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
Parameter
Name | Typ | Beschreibung |
---|---|---|
red | Integer | Der Rotwert in RGB-Notation. |
green | Integer | Der grüne Wert in RGB-Notation. |
blue | Integer | Der Blauwert in RGB-Notation. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgrounds(color)
Legt ein rechteckiges Raster mit Hintergrundfarben fest, die den Abmessungen dieses Bereichs entsprechen müssen. Die Farben
in CSS-Notation geschrieben sind (z. B. '#ffffff'
oder 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setBackgrounds(colors);
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | String[][] | Ein zweidimensionales Farbarray in CSS-Notation (z. B. '#ffffff' oder
'white' ); Mit null -Werten wird die Farbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
Legt die Rahmeneigenschaft fest. Gültige Werte sind true
(on), false
(off) und null
(keine Änderung).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
Parameter
Name | Typ | Beschreibung |
---|---|---|
top | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
left | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
bottom | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
right | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
vertical | Boolean | true für vertikale innere Rahmen, false für keinen und null für keine Änderung. |
horizontal | Boolean | true für horizontale innere Rahmen, false für keinen und null für keine Änderung. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Legt die Rahmeneigenschaft mit Farbe und/oder Stil fest. Gültige Werte sind true
(on), false
(off) und null
(keine Änderung). Verwenden Sie für Farben „Farbe“ in der CSS-Notation (z. B. '#ffffff'
oder 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);
Parameter
Name | Typ | Beschreibung |
---|---|---|
top | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
left | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
bottom | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
right | Boolean | true für Rahmen, false für keinen, null für keine Änderung. |
vertical | Boolean | true für vertikale innere Rahmen, false für keinen und null für keine Änderung. |
horizontal | Boolean | true für horizontale innere Rahmen, false für keinen und null für keine Änderung. |
color | String | Eine Farbe in CSS-Notation (z. B. '#ffffff' oder 'white' ) und null für die Standardfarbe (Schwarz). |
style | BorderStyle | Ein Stil für die Rahmen, null für den Standardstil (durchgehend). |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidation(rule)
Legt eine Datenvalidierungsregel für alle Zellen im Bereich fest.
// Set the data validation rule for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rule | DataValidation | Die festzulegende Datenvalidierungsregel oder null , um die Datenvalidierung zu entfernen. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidations(rules)
Legt die Datenvalidierungsregeln für alle Zellen im Bereich fest. Bei dieser Methode wird eine zweidimensionale Array von Datenvalidierungen, die nach Zeile und dann nach Spalte indexiert sind. Die Array-Abmessungen müssen bis zu den Bereichsdimensionen.
// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10. var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); var rules = destinationRange.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rules | DataValidation[][] | Ein zweidimensionales Array von Datenvalidierungsregeln, die festgelegt werden sollen. null Werte
entfernen Sie die Datenvalidierung. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Legt die Schriftfarbe in der CSS-Notation fest (z. B. '#ffffff'
oder 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontColor("red");
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | String | Die Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white' ) eine
Mit dem Wert null wird die Farbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObject(color)
Legt die Schriftfarbe des angegebenen Bereichs fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var cell = sheet.getRange("B2"); cell.setFontColor(color);
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | Color | Die festzulegende Schriftfarbe; wird der Wert null die Farbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObjects(colors)
Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setFontColorObjects(colors);
Parameter
Name | Typ | Beschreibung |
---|---|---|
colors | Color[][] | Zweidimensionales Array von Farben null -Werte setzen die Schriftfarbe zurück. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColors(colors)
Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen). Die Farben sind
CSS-Notation (z. B. '#ffffff'
oder 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setFontColors(colors);
Parameter
Name | Typ | Beschreibung |
---|---|---|
colors | Object[][] | Ein zweidimensionales Farbarray in CSS-Notation (z. B. '#ffffff' oder
'white' ); Mit null -Werten wird die Farbe zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
Legt ein rechteckiges Raster mit Schriftfamilien fest (muss den Abmessungen dieses Bereichs entsprechen). Beispiele für Schriftartfamilien oder "Helvetica".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var fonts = [ ["Arial", "Helvetica", "Verdana"], ["Courier New", "Arial", "Helvetica] ]; var cell = sheet.getRange("B2:D3"); cell.setFontFamilies(fonts);
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontFamilies | Object[][] | Zweidimensionales Array von Schriftfamilien null -Werte setzen den
Schriftfamilie hinzu. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
Legt die Schriftfamilie fest, z. B. "Arial" oder "Helvetica".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontFamily("Helvetica");
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontFamily | String | Die Schriftfamilie, die festgelegt werden soll wird die Schriftfamilie bei null zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Legt den Linienstil der Schriftart des angegebenen Bereichs ('underline'
, 'line-through'
oder
'none'
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontLine("line-through");
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontLine | String | Der Linienstil der Schriftart, entweder 'underline' , 'line-through' oder
'none' ; wird der Wert für null die Linienart der Schriftart zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLines(fontLines)
Legt ein rechteckiges Raster mit Linienstile fest (muss den Abmessungen dieses Bereichs entsprechen).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontLines = [ ["underline", "line-through", "none"] ]; var range = sheet.getRange("B2:D2"); range.setFontLines(fontLines);
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontLines | Object[][] | Ein zweidimensionales Array von Schriftlinienstilen ('underline' , 'line-through' oder 'none' ) Mit null -Werten wird die Linienart der Schriftart zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Legt die Schriftgröße fest, wobei die Größe die zu verwendende Punktgröße ist.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontSize(20);
Parameter
Name | Typ | Beschreibung |
---|---|---|
size | Integer | Eine Schriftgröße in Punktgröße. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSizes(sizes)
Legt ein rechteckiges Raster mit Schriftgrößen fest (muss den Abmessungen dieses Bereichs entsprechen). Die Größen sind in Punkte.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontSizes = [ [16, 20, 24] ]; var range = sheet.getRange("B2:D2"); range.setFontSizes(fontSizes);
Parameter
Name | Typ | Beschreibung |
---|---|---|
sizes | Object[][] | Ein zweidimensionales Array von Größen. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Legen Sie den Schriftstil für den angegebenen Bereich fest ('italic'
oder 'normal'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontStyle("italic");
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontStyle | String | Der Schriftstil, entweder 'italic' oder 'normal' . null
wird die Schriftart zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyles(fontStyles)
Legt ein rechteckiges Raster mit Schriftstilen fest (muss den Abmessungen dieses Bereichs entsprechen).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ ["italic", "normal"] ]; var range = sheet.getRange("B2:C2"); range.setFontStyles(fontStyles);
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontStyles | Object[][] | Ein zweidimensionales Array von Schriftstilen, entweder 'italic' oder 'normal' ; Die Schriftart für null wird zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
Legen Sie die Schriftstärke für den angegebenen Bereich (normal/fett) fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontWeight("bold");
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontWeight | String | Die Schriftstärke, entweder 'bold' oder 'normal' . null
setzt die Schriftstärke zurück. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeights(fontWeights)
Legt ein rechteckiges Raster mit Schriftstärken fest (muss den Abmessungen dieses Bereichs entsprechen). Ein Beispiel für eine Die Schriftstärke ist „fett“.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ [ "bold", "bold", "normal" ] ]; var range = sheet.getRange("B2:D2"); range.setFontWeights(fontStyles);
Parameter
Name | Typ | Beschreibung |
---|---|---|
fontWeights | Object[][] | Ein zweidimensionales Array von Schriftstärken, entweder 'bold' oder 'normal' . null -Werte setzen die Schriftstärke zurück. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aktualisiert die Formel für diesen Bereich. Die angegebene Formel muss in A1-Schreibweise vorliegen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); cell.setFormula("=SUM(B3:B4)");
Parameter
Name | Typ | Beschreibung |
---|---|---|
formula | String | Ein String, der die für die Zelle festzulegende Formel darstellt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Aktualisiert die Formel für diesen Bereich. Die angegebene Formel muss in der R1C1-Schreibweise angegeben werden.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); // This sets the formula to be the sum of the 3 rows above B5 cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");
Parameter
Name | Typ | Beschreibung |
---|---|---|
formula | String | Eine Zeichenfolgenformel. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulas(formulas)
Legt ein rechteckiges Raster mit Formeln fest (muss den Dimensionen dieses Bereichs entsprechen). Die angegebenen Formeln muss in A1-Schreibweise vorliegen. Diese Methode verwendet ein zweidimensionales Array von Formeln, indiziert nach Zeile, und dann nach Spalte. Die Arrayabmessungen müssen den Bereichsdimensionen entsprechen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This sets the formulas to be a row of sums, followed by a row of averages right below. // The size of the two-dimensional array must match the size of the range. var formulas = [ ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"], ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"] ]; var cell = sheet.getRange("B5:D6"); cell.setFormulas(formulas);
Parameter
Name | Typ | Beschreibung |
---|---|---|
formulas | String[][] | Ein zweidimensionales String-Array mit Formeln. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulasR1C1(formulas)
Legt ein rechteckiges Raster mit Formeln fest (muss den Dimensionen dieses Bereichs entsprechen). Die angegebenen Formeln muss in R1C1-Notation angegeben werden.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates formulas for a row of sums, followed by a row of averages. var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])"; var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])"; // The size of the two-dimensional array must match the size of the range. var formulas = [ [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove], [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove] ]; var cell = sheet.getRange("B5:D6"); // This sets the formula to be the sum of the 3 rows above B5. cell.setFormulasR1C1(formulas);
Parameter
Name | Typ | Beschreibung |
---|---|---|
formulas | String[][] | Zweidimensionales Array von Formeln im R1C1-Format. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Legen Sie die horizontale Ausrichtung (von links nach rechts) für den angegebenen Bereich fest (links/Mitte/rechts).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setHorizontalAlignment("center");
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignment | String | Die Ausrichtung, entweder 'left' , 'center' oder 'normal' . eine
Der Wert null setzt die Ausrichtung zurück. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignments(alignments)
Legt ein rechteckiges Raster horizontaler Ausrichtungen fest. Siehe setHorizontalAlignment(alignment)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var horizontalAlignments = [ [ "left", "right", "center" ] ]; var range = sheet.getRange("B2:D2"); range.setHorizontalAlignments(horizontalAlignments);
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignments | Object[][] | Ein zweidimensionales Array von Ausrichtungen, entweder 'left' , 'center' oder 'normal' . wird ein null -Wert die Ausrichtung zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
setNote(note)
Setzt die Notiz auf den angegebenen Wert.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setNote("This is a note");
Parameter
Name | Typ | Beschreibung |
---|---|---|
note | String | Der für den Bereich festzulegende Notenwert; wird der Wert null entfernt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNotes(notes)
Legt ein rechteckiges Notizenraster fest, das den Abmessungen dieses Bereichs entsprechen muss.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var notes = [ ["it goes", "like this", "the fourth, the fifth"], ["the minor fall", "and the", "major lift"] ]; var cell = sheet.getRange("B2:D3"); cell.setNotes(notes)
Parameter
Name | Typ | Beschreibung |
---|---|---|
notes | Object[][] | Zweidimensionales Array von Notizen null -Werte entfernen die Notiz. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
setNumberFormat(numberFormat)
Legt das Zahlen- oder Datumsformat auf die angegebene Formatierungszeichenfolge fest. Zulässige Formatmuster sind Tabellen API-Dokumentation
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Always show 3 decimal points cell.setNumberFormat("0.000");
Parameter
Name | Typ | Beschreibung |
---|---|---|
numberFormat | String | Ein Zahlenformatstring. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormats(numberFormats)
Legt ein rechteckiges Raster mit Zahlen- oder Datumsformaten fest (muss den Abmessungen dieses Bereichs entsprechen). Die -Werte sind Formatmusterzeichenfolgen, wie in den Sheets API-Dokumentation
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var formats = [ [ "0.000", "0,000,000", "$0.00" ] ]; var range = sheet.getRange("B2:D2"); range.setNumberFormats(formats);
Parameter
Name | Typ | Beschreibung |
---|---|---|
numberFormats | Object[][] | Ein zweidimensionales Array von Zahlenformaten. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValue(value)
Legt den Rich-Text-Wert für die Zellen im Bereich fest.
// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var richText = SpreadsheetApp.newRichTextValue() .setText("Hello world") .setTextStyle(0, 5, bold) .build(); range.setRichTextValue(richText);
Parameter
Name | Typ | Beschreibung |
---|---|---|
value | RichTextValue | Der gewünschte Rich-Text-Wert. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValues(values)
Legt ein rechteckiges Raster mit Rich-Text-Werten fest.
// Sets the cells in range A1:A2 to have Rich Text values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:A2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var italic = SpreadsheetApp.newTextStyle() .setItalic(true) .build(); var richTextA1 = SpreadsheetApp.newRichTextValue() .setText("This cell is bold") .setTextStyle(bold) .build(); var richTextA2 = SpreadsheetApp.newRichTextValue() .setText("bold words, italic words") .setTextStyle(0, 11, bold) .setTextStyle(12, 24, italic) .build(); range.setRichTextValues([[richTextA1], [richTextA2]]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
values | RichTextValue[][] | Die gewünschten Rich-Text-Werte. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
Legt fest, ob der Bereich Hyperlinks enthalten soll.
// 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);
Parameter
Name | Typ | Beschreibung |
---|---|---|
showHyperlink | Boolean | Gibt an, ob der Hyperlink angezeigt werden soll. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Legt die Textrichtung für die Zellen im Bereich fest. Wenn die angegebene Richtung null
ist,
wird die Richtung abgeleitet und dann festgelegt.
// Sets right-to-left text direction for the range. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parameter
Name | Typ | Beschreibung |
---|---|---|
direction | TextDirection | Die gewünschte Textrichtung Bei null wird die Richtung vor dem Ableiten der Richtung abgeleitet.
Einstellung. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirections(directions)
Legt ein rechteckiges Raster mit Wegbeschreibungen fest. Wenn die angegebene Richtung null
ist, wird der
Richtung wird abgeleitet und dann festgelegt.
// Copies all of the text directions from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextDirections());
Parameter
Name | Typ | Beschreibung |
---|---|---|
directions | TextDirection[][] | Die gewünschten Routen in Textform: Die angegebene Richtung ist null .
vor der Einstellung abgeleitet wird. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Legt die Einstellungen für die Textdrehung für die Zellen im Bereich fest. Die Eingabe entspricht dem Winkel Standardtextausrichtung und der gewünschten Ausrichtung ändern. Bei Eingabe von null wird angegeben, dass der Text auf die Standardausrichtung eingestellt ist.
Bei Textrichtung von links nach rechts verlaufen positive Winkel gegen den Uhrzeigersinn. während sie bei rechts nach links im Uhrzeigersinn liegen.
// Sets all cell's in range B2:D4 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setTextRotation(45);
Parameter
Name | Typ | Beschreibung |
---|---|---|
degrees | Integer | Der gewünschte Winkel zwischen der Standardausrichtung und der gewünschten Ausrichtung. Bei Text von links nach rechts verlaufen positive Winkel gegen den Uhrzeigersinn. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(rotation)
Legt die Einstellungen für die Textdrehung für die Zellen im Bereich fest.
// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1. var sheet = SpreadsheetApp.getActiveSheet(); var rotation = sheet.getRange("A1").getTextRotation(); sheet.getRange("B2:D4").setTextRotation(rotation);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rotation | TextRotation | Die gewünschten Einstellungen für die Textrotation. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotations(rotations)
Legt ein rechteckiges Raster mit Textrotationen fest.
// Copies all of the text rotations from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextRotations());
Parameter
Name | Typ | Beschreibung |
---|---|---|
rotations | TextRotation[][] | Die gewünschten Einstellungen für die Textrotation. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyle(style)
Legt den Textstil für die Zellen im Bereich fest.
// Sets the cells in range C5:D6 to have underlined size 15 font. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("C5:D6"); var style = SpreadsheetApp.newTextStyle() .setFontSize(15) .setUnderline(true) .build(); range.setTextStyle(style);
Parameter
Name | Typ | Beschreibung |
---|---|---|
style | TextStyle | Der gewünschte Textstil. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyles(styles)
Legt ein rechteckiges Raster mit Textstilen fest.
// Sets text styles for cells in range A1:B2 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var otherStyle = SpreadsheetApp.newTextStyle() .setBold(true) .setUnderline(true) .setItalic(true) .setForegroundColor("#335522") .setFontSize(44) .build(); range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
styles | TextStyle[][] | Die gewünschten Textstile. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
Legt den Wert des Bereichs fest. Der Wert kann numerisch, String, boolescher Wert oder Datum sein. Wenn er beginnt,
mit '='
wird es als Formel interpretiert.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setValue(100);
Parameter
Name | Typ | Beschreibung |
---|---|---|
value | Object | Der Wert für den Bereich. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValues(values)
Legt ein rechteckiges Raster mit Werten fest (muss den Dimensionen dieses Bereichs entsprechen). Beginnt ein Wert mit
=
wird sie als Formel interpretiert.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var values = [ [ "2.000", "1,000,000", "$2.99" ] ]; var range = sheet.getRange("B2:D2"); range.setValues(values);
Parameter
Name | Typ | Beschreibung |
---|---|---|
values | Object[][] | Zweidimensionales Array von Werten. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Legen Sie die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich fest (oben/Mitte/unten).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setVerticalAlignment("middle");
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignment | String | Die Ausrichtung, entweder 'top' , 'middle' oder 'bottom' . eine
Der Wert null setzt die Ausrichtung zurück. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignments(alignments)
Legt ein rechteckiges Raster mit vertikalen Ausrichtungen fest, die den Abmessungen dieses Bereichs entsprechen müssen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var alignments = [ [ "top", "middle", "bottom" ] ]; var range = sheet.getRange("B2:D2"); range.setVerticalAlignments(alignments);
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignments | Object[][] | Ein zweidimensionales Array von Ausrichtungen, entweder 'top' oder 'middle'
oder 'bottom' ; wird ein null -Wert die Ausrichtung zurückgesetzt. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
setVerticalText(isVertical)
Legt fest, ob der Text für die Zellen im Bereich gestapelt werden soll. Wenn der Text gestapelt ist vertikal ist, wird die Einstellung für den Textdrehungsgrad ignoriert.
// Sets all cell's in range B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setVerticalText(true);
Parameter
Name | Typ | Beschreibung |
---|---|---|
isVertical | Boolean | Gibt an, ob der Text gestapelt werden soll. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
Legen Sie den Zellenumbruch für den angegebenen Bereich fest.
Die Größe von Zellen mit aktiviertem Zeilenumbruch (Standardeinstellung) wird so angepasst, dass ihr gesamter Inhalt angezeigt wird. Zellen mit Zeilenumbruch so viel wie möglich in der Zelle anzuzeigen, ohne dabei die Größe zu ändern oder mehrere Zeilen zu durchlaufen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setWrap(true);
Parameter
Name | Typ | Beschreibung |
---|---|---|
isWrapEnabled | Boolean | Gibt an, ob der Text umgebrochen werden soll. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategies(strategies)
Legt ein rechteckiges Raster mit Umbruchstrategien fest.
// Copies all of the wrap strategies from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setWrapStrategies(range1.getWrapStrategies());
Parameter
Name | Typ | Beschreibung |
---|---|---|
strategies | WrapStrategy[][] | Die gewünschten Wrapping-Strategien. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
Legt die Textumbruchstrategie für die Zellen im Bereich fest.
// Sets all cells in range B2:D4 to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parameter
Name | Typ | Beschreibung |
---|---|---|
strategy | WrapStrategy | Die gewünschte Wrapping-Strategie. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWraps(isWrapEnabled)
Legt ein rechteckiges Raster mit Richtlinien für den Zeilenumbruch fest (muss den Abmessungen dieses Bereichs entsprechen). Zellen mit Umbruch aktiviert (Standardeinstellung): Die Größe wird angepasst, um den gesamten Inhalt anzuzeigen. Zellen mit deaktiviertem Zeilenumbruch so viel wie möglich in der Zelle anzuzeigen, ohne die Größe zu ändern oder auf mehrere Zeilen zu verlaufen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var wraps = [ [ true, true, false ] ]; var range = sheet.getRange("B2:D2"); range.setWraps(wraps);
Parameter
Name | Typ | Beschreibung |
---|---|---|
isWrapEnabled | Object[][] | Ein zweidimensionales Array von Umbruchvariablen, die bestimmen, ob ein Umbruch erfolgen soll Text in einer Zelle ist oder nicht. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
shiftColumnGroupDepth(delta)
Ändert die Spaltengruppierungstiefe des Bereichs um den angegebenen Wert.
Dadurch werden Gruppen erstellt, geändert oder gelöscht, die sich mit dem Bereich. Bei positiven Deltas werden Gruppen erstellt und/oder geändert. bei negativen Deltas werden Gruppen zerstört und/oder modifiziert wurden.
Dies hat keine Auswirkungen, wenn die Gruppentiefe auf unter null oder über acht verringert wird.
Wenn column group control position
gleich
BEFORE
, wird beim Versuch, zu verschieben,
die Tiefe der ersten Zeile.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The column grouping depth is increased by 1. range.shiftColumnGroupDepth(1); // The column grouping depth is decreased by 1. range.shiftColumnGroupDepth(-1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
delta | Integer | Der Wert, um den die Spaltengruppentiefe dieses Bereichs geändert werden soll. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Löst aus
Error
– beim Versuch, die Tiefe der ersten Spalte zu verschieben, wenn der Parameter
Position des Steuerelements ist GroupControlTogglePosition.BEFORE
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
shiftRowGroupDepth(delta)
Ändert die Zeilengruppierungstiefe des Bereichs um den angegebenen Wert.
Dadurch werden Gruppen erstellt, geändert oder gelöscht, die sich mit dem Bereich. Bei positiven Deltas werden Gruppen erstellt und/oder geändert. bei negativen Deltas werden Gruppen zerstört und/oder modifiziert wurden.
Dies hat keine Auswirkungen, wenn die Gruppentiefe auf unter null oder über acht verringert wird.
Wenn row group control position
auf BEFORE
gesetzt ist, wird ein Fehler ausgegeben, wenn versucht wird, die
in der ersten Zeile fest.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The row grouping depth is increased by 1. range.shiftRowGroupDepth(1); // The row grouping depth is decreased by 1. range.shiftRowGroupDepth(-1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
delta | Integer | Der Wert, um den die Zeilengruppentiefe dieses Bereichs geändert werden soll. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Löst aus
Error
– beim Versuch, die Tiefe der ersten Zeile zu verschieben, wenn das Steuerelement
Position ist GroupControlTogglePosition.BEFORE
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(sortSpecObj)
Sortiert die Zellen im angegebenen Bereich nach der angegebenen Spalte und Reihenfolge.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Sorts by the values in the first column (A) range.sort(1); // Sorts by the values in the second column (B) range.sort(2); // Sorts descending by column B range.sort({column: 2, ascending: false}); // Sorts descending by column B, then ascending by column A // Note the use of an array range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]); // For rows that are sorted in ascending order, the "ascending" parameter is // optional, and just an integer with the column can be used instead. Note that // in general, keeping the sort specification consistent results in more readable // code. You can express the earlier sort as: range.sort([{column: 2, ascending: false}, 1]); // Alternatively, if you want all columns to be in ascending order, you can use // the following (this makes column 2 ascending) range.sort([2, 1]); // ... which is equivalent to range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
sortSpecObj | Object | Die Spalten, nach denen sortiert werden soll. |
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns()
Teilt eine Textspalte anhand eines automatisch erkannten Trennzeichens in mehrere Spalten auf.
// A1:A3 has the following values: // A B C // 1 |one,one,one | | | // 2 |two,two,two | | | // 3 |three,three,three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
Teilt eine Textspalte mithilfe der angegebenen Zeichenfolge als benutzerdefiniertes Trennzeichen in mehrere Spalten auf.
// A1:A3 has the following values: // A B C // 1 |one#one#one | | | // 2 |two#two#two | | | // 3 |three#three#three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns('#'); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Parameter
Name | Typ | Beschreibung |
---|---|---|
delimiter | String | Das benutzerdefinierte Trennzeichen, nach dem die Trennung erfolgen soll. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
Teilt eine Textspalte anhand des angegebenen Trennzeichens in mehrere Spalten auf.
// A1:A3 has the following values: // A B C // 1 |one;one;one | | | // 2 |two;two;two | | | // 3 |three;three;three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Parameter
Name | Typ | Beschreibung |
---|---|---|
delimiter | TextToColumnsDelimiter | Das voreingestellte Trennzeichen für die Aufteilung. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Passt den Leerraum (z. B. Leerzeichen, Tabulatoren oder neue Zeilen) in allen Zellen in diesem Bereich an. Entfernen alle Leerzeichen vom Anfang und Ende des Zellentextes aus und reduziert die Teilsequenz von verbleibenden Leerzeichen in ein einzelnes Leerzeichen.
<ph type="x-smartling-placeholder">
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']) range.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
uncheck()
Ändert den Status der Kästchen im Bereich zu „Deaktiviert“ Die Zellen im Bereich werden ignoriert. die derzeit weder den aktivierten noch den deaktivierten Wert enthalten.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'unchecked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.uncheck();
Rückflug
Range
: Dieser Bereich für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets