Halaman ini diterjemahkan oleh Cloud Translation API.

Class Selection

Akses pilihan aktif saat ini di sheet aktif. Pilihan adalah kumpulan sel yang telah disorot pengguna dalam sheet, yang dapat berupa rentang yang tidak berdekatan. Satu sel dalam pilihan adalah sel saat ini, tempat fokus pengguna saat ini adalah. Sel saat ini ditandai dengan batas yang lebih gelap di UI Google Spreadsheet.

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

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getActiveRange()`	`Range`	Menampilkan rentang yang dipilih di sheet aktif, atau `null` jika tidak ada rentang aktif.
`getActiveRangeList()`	`RangeList`	Menampilkan daftar rentang aktif di sheet aktif atau `null` jika tidak ada rentang aktif.
`getActiveSheet()`	`Sheet`	Menampilkan sheet aktif dalam spreadsheet.
`getCurrentCell()`	`Range`	Menampilkan sel saat ini (yang ditandai) yang dipilih dalam salah satu rentang aktif atau `null` jika tidak ada sel saat ini.
`getNextDataRange(direction)`	`Range`	Mulai dari `current cell` dan `active range` dan bergerak ke arah yang ditentukan, akan menampilkan rentang yang disesuaikan dengan tepi rentang yang sesuai telah digeser untuk menutupi `next data cell` sambil tetap mencakup sel saat ini.

Dokumentasi mendetail

`getActiveRange()`

Menampilkan rentang yang dipilih di sheet aktif, atau null jika tidak ada rentang aktif. Jika beberapa rentang dipilih, metode ini hanya akan menampilkan rentang terakhir yang dipilih.

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

Return

Range — Rentang aktif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getActiveRangeList()`

Menampilkan daftar rentang aktif di sheet aktif atau null jika tidak ada rentang aktif.

Jika ada satu rentang yang dipilih, ini akan berperilaku sebagai panggilan getActiveRange().

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

Return

RangeList — Daftar rentang aktif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getActiveSheet()`

Menampilkan sheet aktif dalam spreadsheet.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeSheet = selection.getActiveSheet();

Return

Sheet — Sheet aktif di spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getCurrentCell()`

Menampilkan sel saat ini (yang ditandai) yang dipilih dalam salah satu rentang aktif atau null jika tidak ada sel saat ini.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = selection.getCurrentCell();

Return

Range — Sel saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNextDataRange(direction)`

Mulai dari current cell dan active range dan bergerak ke arah yang ditentukan, akan menampilkan rentang yang disesuaikan dengan tepi rentang yang sesuai telah digeser untuk menutupi next data cell sambil tetap mencakup sel saat ini. Jika rentang aktif tidak terikat di sepanjang dimension arah, rentang aktif asli akan ditampilkan. Jika tidak ada sel atau rentang aktif saat ini, null akan ditampilkan. Ini sama dengan memilih rentang di editor dan menekan 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());

Parameter

Name	Jenis	Deskripsi
`direction`	`Direction`	Arah untuk menemukan sel tepi region data berikutnya.

Return

Range — Rentang yang disesuaikan yang menyertakan sel data, atau null jika tidak ada pilihan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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