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