prependColumn

function prependColumn(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  values?: unknown[] | null,
  options: Options | null | undefined = {}
): GoogleAppsScript.Spreadsheet.Sheet;

prependColumns mit einer einzigen Spalte: zuerst wird Platz geschaffen, sodass nichts Vorhandenes überschrieben wird. Ein Blatt bekommt die Spalte an seinen Anfang; ein Bereich unmittelbar vor seine erste Spalte, wobei die Werte auf den Zeilen des Bereichs landen.

Die Werte kommen als flaches Array von Zellen, von oben nach unten. Ohne sie wird eine leere Spalte eingefügt.

Eine Zelle, deren Text mit = beginnt, wird als Formel geschrieben, nicht als Text — dieselbe Regel wie im Editor.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das Blatt, in das eingefügt wird, oder der Bereich, an dem eingefügt wird.
`values` (optional)	`unknown[] \\| null`	Die Zellen der einen Spalte, von oben nach unten. Ohne Angabe entsteht eine leere Spalte.
`options` (optional) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` fügt hinter den fixierten Spalten ein statt ganz am Anfang. Ein Bereich bestimmt die Stelle selbst, dort bewirkt die Option nichts.

Rückgabewert

GoogleAppsScript.Spreadsheet.Sheet — das Blatt, sodass Aufrufe verkettet werden können.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	Werte übergeben wurden, die kein nicht-leeres flaches Array sind.
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.

Beispiele

Am Anfang eines Blatts einfügen

const sheet = SpreadsheetApp.getActiveSheet();

prependColumn(sheet, ["Name", "Ada", "Grace"]);

An einem Bereich einfügen

const sheet = SpreadsheetApp.getActiveSheet();

prependColumn(sheet.getRange("C4:F13"), ["Name", "Ada"]);

Siehe auch

Quellcode

src/appsscript/sheet/prependColumn.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.