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