Class Selection

Zaznaczenie

Otwórz bieżący wybór w aktywnym arkuszu. Zaznaczenie to zbiór komórek zaznaczonych przez użytkownika w arkuszu, które mogą stanowić zakresy, które nie sąsiadują ze sobą. Jedna z zaznaczonych komórek to obecna komórka, w której aktualnie znajduje się użytkownik. Bieżąca komórka jest wyróżniona ciemniejszym obramowaniem 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
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

MetodaZwracany typKrótki opis
getActiveRange()RangeZwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu.
getActiveRangeList()RangeListZwraca listę aktywnych zakresów w aktywnym arkuszu lub zmienną null, jeśli nie ma aktywnych zakresów.
getActiveSheet()SheetZwraca aktywny arkusz w arkuszu kalkulacyjnym.
getCurrentCell()RangeZwraca bieżącą (wyróżnioną) komórkę wybraną w jednym z aktywnych zakresów lub null, jeśli nie ma bieżącej komórki.
getNextDataRange(direction)RangeZaczynając od current cell i active range i przesuwając się w wybranym kierunku, zwraca dostosowany zakres, w którym odpowiednia krawędź zakresu została przesunięta tak, by zakryć next data cell, nie zasłaniając 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();

Odbicie

Range – aktywny zakres.

Upoważnienie

Skrypty, które używają 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 zmienną 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();

Odbicie

RangeList – lista aktywnych zakresów.

Upoważnienie

Skrypty, które używają 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();

Odbicie

Sheet – aktywny arkusz w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty, które używają 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 bieżącą (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();

Odbicie

Range – bieżąca komórka,

Upoważnienie

Skrypty, które używają 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 i przesuwając się w wybranym kierunku, zwraca dostosowany zakres, w którym odpowiednia krawędź zakresu została przesunięta tak, by zakryć next data cell, nie zasłaniając bieżącej komórki. Jeśli zakres aktywnego ruchu jest ograniczony do dimension kierunku, zwracany jest pierwotny zakres aktywny. Jeśli nie ma bieżącej komórki ani aktywnego zakresu, zwracana jest wartość null. Odpowiada to wybraniu zakresu w edytorze i naciśnię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

NazwaTypOpis
directionDirectionKierunek, w którym znajduje się komórka brzegowa następnego obszaru danych.

Odbicie

Range – dostosowany zakres obejmujący komórkę danych lub null, jeśli nie jest zaznaczony żaden fragment.

Upoważnienie

Skrypty, które używają 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