Class Selection

Zaznaczenie

Otwórz bieżący wybór w aktywnym arkuszu. Wybór to zbiór komórek zaznaczonych w arkuszu przez użytkownika, które mogą stanowić zakres, który nie pasuje do siebie. Wybrana komórka to bieżąca komórka, w której obecnie koncentruje się użytkownik. Bieżąca komórka jest podświetlona w interfejsie Arkuszy Google.

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

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 null, jeśli nie ma aktywnych zakresów.
getActiveSheet()	Sheet	Zwraca aktywny arkusz w arkuszu kalkulacyjnym.
getCurrentCell()	Range	Zwraca aktualną (wyróżnioną) komórkę wybraną w jednym z aktywnych zakresów lub null, jeśli nie ma bieżącej komórki.
getNextDataRange(direction)	Range	Zaczynając od current cell i active range w określonym kierunku, zwraca dostosowany zakres, w którym odpowiednia krawędź zakresu została przesunięta tak, by zakryć obszar next data cell przy zachowaniu bieżącej komórki.

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 ostatni wybrany zakres.

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

Zwróć

Range – aktywny zakres

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 null, jeśli nie ma aktywnych zakresów.

Jeśli wybierzesz jeden zakres, będzie to działać jako wywołanie getActiveRange().

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

Zwróć

RangeList – lista aktywnych zakresów,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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();

Zwróć

Sheet – aktywny arkusz w arkuszu kalkulacyjnym

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

---

getCurrentCell()

Zwraca aktualną (wyróżnioną) komórkę wybraną w jednym z aktywnych zakresów lub 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();

Zwróć

Range – bieżąca komórka,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 w określonym kierunku, zwraca dostosowany zakres, w którym odpowiednia krawędź zakresu została przesunięta tak, by zakryć obszar next data cell przy zachowaniu bieżącej komórki. Jeśli dimension jest aktywny, ale nie ogranicza zakresu aktywnego, zwracany jest pierwotny zakres aktywny. Jeśli nie ma bieżącego komórki ani 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"
Logger.log(SpreadsheetApp.getSelection().getNextDataRange(Direction.UP).getA1Notation());

Parametry

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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