Class Selection

Wybór

Umożliwia dostęp do aktualnie aktywnych elementów w aktywnym arkuszu. Zaznaczenie to zbiór komórek, które użytkownik może być zaznaczonym zakresem w arkuszu, który może nie przylegać do siebie. Jedna komórka w tym zaznaczeniu to bieżąca komórka, na której obecnie znajduje się fokus użytkownika. Bieżąca komórka jest podświetlona ciemniejsze obramowanie 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 null, jeśli nie ma żadnych aktywnych zakresów zakresów.
getActiveSheet()SheetZwraca aktywny arkusz w arkuszu kalkulacyjnym.
getCurrentCell()RangeZwraca obecną (wyróżnioną) komórkę, która jest zaznaczona w jednym z aktywnych zakresów, lub null, jeśli nie ma żadnej bieżącej komórki.
getNextDataRange(direction)RangeOd current cell i active range i przemieszcza się w danym kierunku, zwraca skorygowany zakres, gdzie odpowiednia krawędź zakres został przesunięty tak, aby objął next data cell, podczas gdy zakrywającą bieżącą komórkę.

Szczegółowa dokumentacja

getActiveRange()

Zwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu. Jeśli wybrano wiele zakresów. Ta metoda zwraca tylko ostatnio wybrany zakres. 

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

Powrót

Range – aktywny zakres.

Autoryzacja

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 null, jeśli nie ma żadnych aktywnych zakresów zakresów.

Jeśli wybierzesz 1 zakres, ta operacja będzie działać jak wywołanie getActiveRange(). 

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

Powrót

RangeList – lista aktywnych zakresów.

Autoryzacja

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

Powrót

Sheet – aktywny arkusz w arkuszu kalkulacyjnym.

Autoryzacja

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 obecną (wyróżnioną) komórkę, która jest zaznaczona w jednym z aktywnych zakresów, lub null, jeśli nie ma żadnej 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();

Powrót

Range – bieżąca komórka,

Autoryzacja

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)

Od current cell i active range i przemieszcza się w danym kierunku, zwraca skorygowany zakres, gdzie odpowiednia krawędź zakres został przesunięty tak, aby objął next data cell, podczas gdy co zakrywa bieżącą komórkę. Jeśli aktywny zakres jest nieograniczony wzdłuż dimension kierunku, zwracany jest pierwotny zakres aktywny. Jeśli nie ma bieżącej komórki lub zakres aktywny, zwracana jest wartość null. Odpowiada to wybraniu zakresu w w edytorze i kliknij 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 należy znaleźć następną komórkę brzegową regionu danych.

Powrót

Range – skorygowany zakres obejmujący komórkę danych lub null, jeśli nie ma wyboru.

Autoryzacja

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