apps-script-utils (Українська) 2.1.1 Help

requireGridRangeContainedIn

function requireGridRangeContainedIn( gridRange: GridRange, containerGridRange: GridRange, message?: string ): GridRange;

Стверджувальна форма isGridRangeContainedIn. Типове повідомлення називає обидва діапазони в нотації A1 — саме це робить помилку читабельною в журналі виконання.

Параметри

Параметр

Тип

Опис

gridRange

GridRange

The grid range that must be contained.

containerGridRange

GridRange

The grid range expected to contain it.

message (необов'язковий)

string

Повідомлення винятку. Якщо не задано, використовується повідомлення з обома діапазонами.

Повертає

GridRange — перший діапазон без змін.

Винятки

Виняток

Умова

InvalidGridRangeException

перший діапазон не лежить усередині другого.

Приклади

Захист запису

const inner = { startRowIndex: 1, endRowIndex: 2, startColumnIndex: 1, endColumnIndex: 2 }; const outer = { startRowIndex: 0, endRowIndex: 5, startColumnIndex: 0, endColumnIndex: 5 }; requireGridRangeContainedIn(inner, outer); // => the inner range

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

Вихідний код

src/appsscript/sheet/requireGridRangeContainedIn.ts

23 September 2026

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