Class Selection

Pilihan

Mengakses pilihan yang aktif saat ini di sheet yang aktif. Pilihan adalah kumpulan sel yang dipilih pengguna telah disorot di {i>sheet<i}, yang bisa jadi merupakan rentang yang tidak berdekatan. Satu sel yang dipilih adalah sel saat ini, tempat fokus pengguna saat ini berada. Sel saat ini disorot dengan batas yang lebih gelap di UI Google Sheets.

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getActiveRange()RangeMenampilkan rentang yang dipilih dalam sheet aktif, atau null jika tidak ada rentang yang aktif.
getActiveRangeList()RangeListMenampilkan daftar rentang aktif dalam sheet aktif atau null jika tidak ada yang aktif rentang.
getActiveSheet()SheetMenampilkan sheet aktif di spreadsheet.
getCurrentCell()RangeMenampilkan sel saat ini (ditandai) yang dipilih di salah satu rentang aktif atau null jika tidak ada sel saat ini.
getNextDataRange(direction)RangeMulai dari current cell dan active range dan bergerak ke arah yang ditentukan, mengembalikan rentang yang disesuaikan di mana tepi yang sesuai dari rentang telah digeser untuk mencakup next data cell sambil tetap yang membahas sel saat ini.

Dokumentasi mendetail

getActiveRange()

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

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

Pulang pergi

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 dalam sheet aktif atau null jika tidak ada yang aktif rentang.

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

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

Pulang pergi

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 di spreadsheet.

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

Pulang pergi

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 (ditandai) yang dipilih di 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();

Pulang pergi

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, mengembalikan rentang yang disesuaikan di mana tepi yang sesuai dari rentang telah digeser untuk mencakup next data cell sambil tetap yang membahas sel saat ini. Jika rentang aktif tidak dibatasi di sepanjang dimension arah, rentang aktif yang asli akan ditampilkan. Jika tidak ada sel saat ini atau rentang aktif, null ditampilkan. Ini sama seperti memilih rentang dalam 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

NamaJenisDeskripsi
directionDirectionArah untuk menemukan sel edge region data berikutnya.

Pulang pergi

Range — Rentang yang disesuaikan yang mencakup 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