prependColumns

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

Zuerst wird Platz geschaffen, dann werden die Werte hineingeschrieben, sodass nichts Vorhandenes überschrieben wird. Bei einem Blatt stehen die Spalten an dessen Anfang; bei einem Bereich vor dessen erster Spalte, und die Werte werden auf seinen Zeilen geschrieben.

Die Matrix ist erst nach Zeile, dann nach Spalte indiziert und muss genau count Spalten breit sein. Ohne Werte entstehen leere Spalten.

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.
`count`	`number`	Wie viele Spalten eingefügt werden. `0` tut nichts.
`values` (optional)	`unknown[][] \\| null`	Eine nach Zeile und Spalte indizierte Matrix, genau `count` Spalten breit. Ohne sie entstehen leere Spalten.
`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`	`count` keine nicht-negative sichere Ganzzahl ist oder die Werte nicht dazu passen.
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.

Beispiele

Am Anfang eines Blatts einfügen

const sheet = SpreadsheetApp.getActiveSheet();

prependColumns(sheet, 2, [
  ["A1", "B1"],
  ["A2", "B2"]
]);

An einem Bereich einfügen

const sheet = SpreadsheetApp.getActiveSheet();

prependColumns(sheet.getRange("C4:F13"), 1, [["note"]]);

Siehe auch

Quellcode

src/appsscript/sheet/prependColumns.ts

23 September 2026

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