Class Selection

Auswahl

Rufen Sie die aktuell aktive Auswahl im aktiven Tabellenblatt auf. Eine Auswahl besteht aus den Zellen, die der Nutzer im Tabellenblatt markiert hat. Dabei können auch nicht zusammenhängende Bereiche ausgewählt werden. Eine Zelle in der Auswahl ist die aktuelle Zelle, auf die der Fokus des Nutzers gerade gerichtet ist. Die aktuelle Zelle ist in der Google Tabellen-Benutzeroberfläche mit einem dunkleren Rahmen hervorgehoben.

const activeSheet = SpreadsheetApp.getActiveSheet();
const rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

const selection = activeSheet.getSelection();
// Current Cell: D1
console.log(`Current Cell: ${selection.getCurrentCell().getA1Notation()}`);
// Active Range: D1:E4
console.log(`Active Range: ${selection.getActiveRange().getA1Notation()}`);
// Active Ranges: A1:B4, D1:E4
const ranges = selection.getActiveRangeList().getRanges();
for (let i = 0; i < ranges.length; i++) {
  console.log(`Active Ranges: ${ranges[i].getA1Notation()}`);
}
console.log(`Active Sheet: ${selection.getActiveSheet().getName()}`);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getActiveRange()	Range	Gibt den ausgewählten Bereich im aktiven Tabellenblatt zurück oder null, wenn kein aktiver Bereich vorhanden ist.
getActiveRangeList()	RangeList	Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt zurück oder null, wenn keine aktiven Bereiche vorhanden sind.
getActiveSheet()	Sheet	Gibt das aktive Tabellenblatt in der Tabelle zurück.
getCurrentCell()	Range	Gibt die aktuelle (markierte) Zelle zurück, die in einem der aktiven Bereiche ausgewählt ist, oder null, wenn keine aktuelle Zelle vorhanden ist.
getNextDataRange(direction)	Range	Wenn Sie von current cell und active range ausgehen und sich in die angegebene Richtung bewegen, wird ein angepasster Bereich zurückgegeben, bei dem der entsprechende Rand des Bereichs so verschoben wurde, dass er die next data cell abdeckt und gleichzeitig die aktuelle Zelle.

Detaillierte Dokumentation

getActiveRange()

Gibt den ausgewählten Bereich im aktiven Tabellenblatt zurück oder null, wenn kein aktiver Bereich vorhanden ist. Wenn mehrere Bereiche ausgewählt sind, gibt diese Methode nur den zuletzt ausgewählten Bereich zurück.

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeRange = selection.getActiveRange();

Rückflug

Range – der aktive Bereich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getActiveRangeList()

Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt zurück oder null, wenn keine aktiven Bereiche vorhanden sind.

Wenn nur ein Bereich ausgewählt ist, verhält sich das Ganze wie ein getActiveRange()-Aufruf.

const sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
const activeRangeList = sheet.getActiveRangeList();

Rückflug

RangeList: Liste der aktiven Bereiche.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getActiveSheet()

Gibt das aktive Tabellenblatt in der Tabelle zurück.

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeSheet = selection.getActiveSheet();

Rückflug

Sheet: Das aktive Tabellenblatt in der Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getCurrentCell()

Gibt die aktuelle (markierte) Zelle zurück, die in einem der aktiven Bereiche ausgewählt ist, oder null, wenn keine aktuelle Zelle vorhanden ist.

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
const currentCell = selection.getCurrentCell();

Rückflug

Range: Die aktuelle Zelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getNextDataRange(direction)

Wenn Sie von current cell und active range ausgehen und sich in die angegebene Richtung bewegen, wird ein angepasster Bereich zurückgegeben, bei dem der entsprechende Rand des Bereichs so verschoben wurde, dass er die next data cell abdeckt und gleichzeitig die aktuelle Zelle. Wenn der aktive Bereich entlang der dimension der Richtung unbegrenzt ist, wird der ursprüngliche aktive Bereich zurückgegeben. Wenn keine aktuelle Zelle oder kein aktiver Bereich vorhanden ist, wird null zurückgegeben. Das entspricht dem Auswählen eines Bereichs im Editor und dem Drücken der Taste Ctrl+Shift+[arrow key].

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Makes C3 the current cell and C3:E5 the active range.
sheet.getRange('C3:E5').activate();
// Logs 'C1:E3'
console.log(
    SpreadsheetApp.getSelection()
        .getNextDataRange(SpreadsheetApp.Direction.UP)
        .getA1Notation(),
);

Parameter

Name	Typ	Beschreibung
direction	Direction	Die Richtung, in der die nächste Zelle am Rand des Datenbereichs gefunden werden soll.

Rückflug

Range: Der angepasste Bereich, der die Datenzelle enthält, oder null, wenn keine Auswahl getroffen wurde.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets