Class Selection

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auswahl

Greifen Sie im aktiven Tabellenblatt auf die aktuell aktive Auswahl zu. Eine Auswahl ist die Gruppe von Zellen, die der Nutzer im Tabellenblatt hervorgehoben hat. Das können nicht-benachbarte Bereiche sein. Eine Zelle der Auswahl ist die aktuelle Zelle mit dem aktuellen Fokus des Nutzers. Die aktuelle Zelle wird in der Google Tabellen-Benutzeroberfläche mit einem dunkleren Rahmen hervorgehoben. 

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

var selection = activeSheet.getSelection();
// Current Cell: D1
Logger.log('Current Cell: ' + selection.getCurrentCell().getA1Notation());
// Active Range: D1:E4
Logger.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++) {
  Logger.log('Active Ranges: ' + ranges[i].getA1Notation());
}
Logger.log('Active Sheet: ' + selection.getActiveSheet().getName());

Methoden

MethodeRückgabetypKurzbeschreibung
getActiveRange()RangeGibt den ausgewählten Bereich im aktiven Tabellenblatt oder null zurück, wenn kein Bereich aktiv ist
getActiveRangeList()RangeListGibt die Liste der aktiven Bereiche im aktiven Tabellenblatt oder null zurück, wenn keine aktiven Bereiche vorhanden sind.
getActiveSheet()SheetGibt das aktive Tabellenblatt in der Tabelle zurück.
getCurrentCell()RangeGibt die aktuelle (hervorgehobene) Zelle zurück, die in einem der aktiven Bereiche ausgewählt wurde, oder null, wenn keine aktuelle Zelle vorhanden ist.
getNextDataRange(direction)RangeAb current cell und active range wird der angepasste Bereich zurückgegeben, in dem der entsprechende Rand des Bereichs verschoben wurde, um next data cell abzudecken, während die aktuelle Zelle weiterhin abgedeckt ist.

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 letzten ausgewählten Bereich zurück. 

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

Zurücksenden

Range: der aktive Bereich

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Wurde ein einzelner Bereich ausgewählt, entspricht dies einem getActiveRange()-Aufruf. 

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

Zurücksenden

RangeList: Liste der aktiven Bereiche

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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();

Zurücksenden

Sheet: Das aktive Tabellenblatt in der Tabelle.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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 wurde, 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();

Zurücksenden

Range: die aktuelle Zelle

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getNextDataRange(direction)

Ab current cell und active range wird der angepasste Bereich zurückgegeben, in dem der entsprechende Rand des Bereichs verschoben wurde, um next data cell abzudecken, während die aktuelle Zelle weiterhin abgedeckt ist. Wenn der aktive Bereich entlang der dimension der Richtung unbegrenzt ist, wird der ursprüngliche aktive Bereich zurückgegeben. Wenn es keine aktuelle Zelle oder keinen aktiven Bereich gibt, wird null zurückgegeben. Dies entspricht dem Auswählen eines Bereichs im Editor und dem Drücken von Ctrl+Shift+[arrow key]. 

// 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"
Logger.log(SpreadsheetApp.getSelection().getNextDataRange(Direction.UP).getA1Notation());

Parameter

NameTypBeschreibung
directionDirectionDie Richtung, in der die nächste Zelle des Datenspeicherortes zu finden ist.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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