apps-script-utils (Deutsch) 2.1.1 Help

requireGridRangeContainedIn

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

Die behauptende Form von isGridRangeContainedIn. Die Standardmeldung nennt beide Bereiche in A1-Notation, was den Fehlschlag im Ausführungsprotokoll lesbar macht.

Parameter

Parameter

Typ

Beschreibung

gridRange

GridRange

The grid range that must be contained.

containerGridRange

GridRange

The grid range expected to contain it.

message (optional)

string

Die Meldung der Ausnahme. Ohne Angabe wird eine genannte Standardmeldung mit beiden Bereichen verwendet.

Rückgabewert

GridRange — den ersten Bereich, unverändert.

Ausnahmen

Ausnahme

Bedingung

InvalidGridRangeException

der erste Bereich liegt nicht im zweiten.

Beispiele

Einen Schreibvorgang absichern

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

Siehe auch

Quellcode

src/appsscript/sheet/requireGridRangeContainedIn.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.