Class Selection

Zaznaczenie

Dostęp do aktualnie aktywnego zaznaczenia w aktywnym arkuszu. Wybór to zestaw komórek wyróżnionych w arkuszu. Mogą to być zakresy, które nie sąsiadują ze sobą. Jedna komórka w tym zaznaczeniu to bieżąca komórka, na której znajduje się aktualnie aktywny użytkownik. W interfejsie Arkuszy Google bieżąca komórka jest podświetlona ciemniejszym obramowaniem.

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

Metody

Metoda	Zwracany typ	Krótki opis
getActiveRange()	Range	Zwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu.
getActiveRangeList()	RangeList	Zwraca listę aktywnych zakresów w aktywnym arkuszu lub funkcję null, jeśli nie ma aktywnych zakresów.
getActiveSheet()	Sheet	Zwraca aktywny arkusz w arkuszu kalkulacyjnym.
getCurrentCell()	Range	Zwraca bieżącą (podświetloną) komórkę, która jest wybrana w jednym z aktywnych zakresów, lub wartość null, jeśli nie ma bieżącej komórki.
getNextDataRange(direction)	Range	Zaczynając od current cell i active range, zwracając dostosowany zakres w miejscu, w którym odpowiednia krawędź zakresu została przesunięta, aby pokryć obszar next data cell, a jednocześnie nadal zakrywała bieżącą komórkę.

Szczegółowa dokumentacja

getActiveRange()

Zwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu. Jeśli wybierzesz wiele zakresów, ta metoda zwróci tylko ostatnio wybrany zakres.

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

Powroty

Range – aktywny zakres.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getActiveRangeList()

Zwraca listę aktywnych zakresów w aktywnym arkuszu lub funkcję null, jeśli nie ma aktywnych zakresów.

Jeśli został wybrany 1 zakres, działa to jak wywołanie getActiveRange().

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

Powroty

RangeList – lista aktywnych zakresów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getActiveSheet()

Zwraca aktywny arkusz w arkuszu kalkulacyjnym.

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

Powroty

Sheet – aktywny arkusz w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getCurrentCell()

Zwraca bieżącą (podświetloną) komórkę, która jest wybrana w jednym z aktywnych zakresów, lub wartość null, jeśli nie ma bieżącej komórki.

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

Powroty

Range – bieżąca komórka.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getNextDataRange(direction)

Zaczynając od current cell i active range, zwracając dostosowany zakres w miejscu, w którym odpowiednia krawędź zakresu została przesunięta, aby pokryć obszar next data cell, a jednocześnie nadal zakrywała bieżącą komórkę. Jeśli aktywny zakres nie jest ograniczony wzdłuż dimension kierunku, zwracany jest pierwotny zakres aktywny. Jeśli nie ma bieżącej komórki lub aktywnego zakresu, zwracana jest wartość null. Odpowiada to wybraniu zakresu w edytorze i kliknięciu 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'
console.log(SpreadsheetApp.getSelection()
                          .getNextDataRange(SpreadsheetApp.Direction.UP)
                          .getA1Notation());

Parametry

Nazwa	Typ	Opis
direction	Direction	Kierunek, w którym należy znaleźć następną komórkę brzegową regionu danych.

Powroty

Range – dostosowany zakres obejmujący komórkę z danymi lub null, jeśli nie wybrano żadnej komórki.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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