isGridRangeContainedIn

function isGridRangeContainedIn(gridRange: GridRange, containerGridRange: GridRange): boolean;

L'inclusion est large : une plage se contient elle-même. Une borne absente sur la plage extérieure signifie qu'elle est ouverte de ce côté et contient donc tout sur cet axe — c'est ainsi que s'expriment une colonne entière ou une feuille entière.

C'est la vérification à faire avant d'écrire dans une plage choisie par l'utilisateur, pour qu'une écriture ne déborde pas de la zone dont le script a la charge.

Paramètres

Paramètre	Type	Description
`gridRange`	`GridRange`	The `GridRange` object that is potentially a subset (child range).
`containerGridRange`	`GridRange`	The `GridRange` object that is potentially a superset (parent range).

Valeur de retour

boolean — true si la première plage est à l'intérieur de la seconde.

Exemples

Vérifier l'inclusion

const inner = { startRowIndex: 1, endRowIndex: 2, startColumnIndex: 1, endColumnIndex: 2 };
const outer = { startRowIndex: 0, endRowIndex: 5, startColumnIndex: 0, endColumnIndex: 5 };

isGridRangeContainedIn(inner, outer); // => true

Voir aussi

Code source

src/appsscript/sheet/isGridRangeContainedIn.ts

23 September 2026

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