apps-script-utils (Français) 2.1.1 Help

requireGridRangeContainedIn

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

La forme assertive d' isGridRangeContainedIn. Le message par défaut nomme les deux plages en notation A1, ce qui rend l'échec lisible dans le journal d'exécution.

Paramètres

Paramètre

Type

Description

gridRange

GridRange

The grid range that must be contained.

containerGridRange

GridRange

The grid range expected to contain it.

message (facultatif)

string

Le message de l'exception. À défaut, un message nommant les deux plages est utilisé.

Valeur de retour

GridRange — la première plage, inchangée.

Exceptions

Exception

Condition

InvalidGridRangeException

la première plage n'est pas contenue dans la seconde.

Exemples

Garder une écriture

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

Voir aussi

Code source

src/appsscript/sheet/requireGridRangeContainedIn.ts

23 September 2026

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