prependColumns

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

Спершу звільняється місце, потім у нього пишуться значення, тож ніщо з наявного на аркуші не перезаписується. Передано аркуш — стовпці йдуть на його початок; передано діапазон — перед першим стовпцем діапазону, а значення пишуться за його рядками.

Матриця індексується спершу за рядком, потім за стовпцем, і її ширина має дорівнювати count. Без значень вставляються порожні стовпці.

Клітинка, текст якої починається з =, записується як формула, а не як текст — за тим самим правилом, що й у редакторі.

Параметри

Параметр	Тип	Опис
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Аркуш, до якого вставляємо, або діапазон, біля якого вставляємо.
`count`	`number`	Скільки стовпців вставити. `0` не робить нічого.
`values` (необов'язковий)	`unknown[][] \\| null`	Матриця за рядками та стовпцями завширшки рівно `count`. Без неї вставляються порожні стовпці.
`options` (необов'язковий) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` вставляє після закріплених стовпців, а не на самий початок. Діапазон задає позицію сам, тож там опція нічого не змінює.

Повертає

GoogleAppsScript.Spreadsheet.Sheet — аркуш, щоб виклики можна було об'єднувати в ланцюжок.

Винятки

Виняток	Умова
`IllegalArgumentException`	`count` не є невід'ємним безпечним цілим, або значення йому не відповідають.
`InvalidSheetException`	перший аргумент не є ні аркушем, ні діапазоном.

Приклади

Вставка на початок аркуша

const sheet = SpreadsheetApp.getActiveSheet();

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

Вставка біля діапазону

const sheet = SpreadsheetApp.getActiveSheet();

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

Дивіться також

Вихідний код

src/appsscript/sheet/prependColumns.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.