prependColumn

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

prependColumns avec une seule colonne : la place est faite d'abord, donc rien de ce qui existe n'est écrasé. Une feuille reçoit la colonne à son début ; une plage la reçoit juste avant sa première colonne, les valeurs étant écrites sur les lignes de la plage.

Les valeurs se donnent comme un tableau plat de cellules, de haut en bas. Sans elles, une colonne vide est insérée.

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.
`values` (facultatif)	`unknown[] \\| null`	Les cellules de la colonne, de haut en bas. Omettez-les pour une colonne vide.
`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`	des valeurs sont fournies mais ne forment pas un tableau plat non vide.
`InvalidSheetException`	le premier argument n'est ni une feuille ni une plage.

Exemples

Insertion au début d'une feuille

const sheet = SpreadsheetApp.getActiveSheet();

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

Insertion au niveau d'une plage

const sheet = SpreadsheetApp.getActiveSheet();

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

Voir aussi

Code source

src/appsscript/sheet/prependColumn.ts

23 September 2026

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