Class Selection

Auswahl

Sie können auf die aktuell aktive Auswahl im aktiven Tabellenblatt zugreifen. Eine Auswahl ist die Gruppe von Zellen, die im Tabellenblatt markiert sind. Dabei kann es sich um nicht nebeneinanderliegende Bereiche handeln. Eine Zelle in der Auswahl ist die Aktuelle Zelle, in der der aktuelle Fokus des Nutzers liegt. Die aktuelle Zelle wird mit einem auf der Benutzeroberfläche von Google Tabellen.

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

var 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
var ranges =  selection.getActiveRangeList().getRanges();
for (var 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 oder null zurück, wenn kein Bereich aktiv ist.
getActiveRangeList()	RangeList	Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt oder null zurück, wenn keine aktiven Bereiche vorhanden sind Bereiche.
getActiveSheet()	Sheet	Gibt das aktive Tabellenblatt in der Tabelle zurück.
getCurrentCell()	Range	Gibt die aktuelle (hervorgehobene) Zelle zurück, die in einem der aktiven Bereiche ausgewählt ist, oder null, wenn keine aktuelle Zelle vorhanden ist.
getNextDataRange(direction)	Range	Ab current cell und active range Bei Bewegung in die angegebene Richtung wird ein angepasster Bereich zurückgegeben, an dem die entsprechende Kante des Der Bereich wurde verschoben und deckt next data cell ab, wobei immer noch die die aktuelle Zelle abdeckt.

Detaillierte Dokumentation

getActiveRange()

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

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

Rückflug

Range: Der aktive Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 oder null zurück, wenn keine aktiven Bereiche vorhanden sind Bereiche.

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

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

Rückflug

RangeList: Die Liste der aktiven Bereiche.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.

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

Rückflug

Sheet: Das aktive Tabellenblatt in der Tabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

getCurrentCell()

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

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

Rückflug

Range: Die aktuelle Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

getNextDataRange(direction)

Ab current cell und active range Bei Bewegung in die angegebene Richtung wird ein angepasster Bereich zurückgegeben, an dem die entsprechende Kante des Der Bereich wurde verschoben und deckt next data cell ab, wobei immer noch die die aktuelle Zelle abdeckt. Wenn der aktive Bereich entlang der dimension der Richtung unbegrenzt ist, wird der ursprüngliche aktive Bereich zurückgegeben. Wenn keine Zelle vorhanden ist oder aktiven Bereich ist, wird null zurückgegeben. Dies entspricht der Auswahl eines Bereichs in der und Ctrl+Shift+[arrow key] drücken.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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 Datenbereich-Randzelle gefunden werden soll.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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