prependColumns

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

La place est faite d'abord, puis les valeurs y sont écrites : rien de ce qui se trouve déjà dans la feuille n'est écrasé. Avec une feuille, les colonnes vont à son début ; avec une plage, juste avant sa première colonne, et les valeurs sont écrites sur ses lignes.

La matrice est indexée par ligne puis par colonne et doit faire exactement count colonnes de large. Sans valeurs, les colonnes insérées restent vides.

Une cellule dont le texte commence par = est écrite comme une formule, pas comme du texte — la règle de l'éditeur.

Paramètres

Paramètre	Type	Description
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	La feuille dans laquelle insérer, ou la plage au niveau de laquelle insérer.
`count`	`number`	Combien de colonnes insérer. `0` ne fait rien.
`values` (facultatif)	`unknown[][] \\| null`	Une matrice indexée par ligne puis colonne, large d'exactement `count`. Omettez-la pour des colonnes vides.
`options` (facultatif) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` insère après les colonnes figées plutôt qu'au tout début. Une plage décide elle-même de la position : l'option n'y change rien.

Valeur de retour

GoogleAppsScript.Spreadsheet.Sheet — la feuille, afin de chaîner les appels.

Exceptions

Exception	Condition
`IllegalArgumentException`	`count` n'est pas un entier sûr positif ou nul, ou les valeurs ne lui correspondent pas.
`InvalidSheetException`	le premier argument n'est ni une feuille ni une plage.

Exemples

Insertion au début d'une feuille

const sheet = SpreadsheetApp.getActiveSheet();

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

Insertion au niveau d'une plage

const sheet = SpreadsheetApp.getActiveSheet();

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

Voir aussi

Code source

src/appsscript/sheet/prependColumns.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.