Trang này được dịch bởi Cloud Translation API.

Class Selection

Truy cập vào lựa chọn đang hoạt động trong trang tính đang hoạt động. Lựa chọn là tập hợp ô mà người dùng đã đánh dấu trong trang tính, có thể là các dải ô không liền kề. Một ô trong lựa chọn là ô hiện tại, nơi tiêu điểm hiện tại của người dùng. Ô hiện tại được làm nổi bật bằng đường viền tối hơn trong giao diện người dùng Google Trang tính.

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

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`getActiveRange()`	`Range`	Trả về dải ô đã chọn trong trang tính đang hoạt động hoặc `null` nếu không có dải ô nào đang hoạt động.
`getActiveRangeList()`	`RangeList`	Trả về danh sách các dải ô đang hoạt động trong trang tính đang hoạt động hoặc `null` nếu không có dải ô nào đang hoạt động.
`getActiveSheet()`	`Sheet`	Trả về trang tính đang hoạt động trong bảng tính.
`getCurrentCell()`	`Range`	Trả về ô hiện tại (được đánh dấu) được chọn ở một trong các dải ô đang hoạt động hoặc `null` nếu không có ô hiện tại.
`getNextDataRange(direction)`	`Range`	Bắt đầu từ `current cell` và `active range` và di chuyển theo hướng nhất định, trả về một phạm vi đã điều chỉnh, trong đó cạnh thích hợp của phạm vi đã được dịch chuyển để bao phủ `next data cell` trong khi vẫn che phủ ô hiện tại.

Tài liệu chi tiết

`getActiveRange()`

Trả về dải ô đã chọn trong trang tính đang hoạt động hoặc null nếu không có dải ô nào đang hoạt động. Nếu bạn chọn nhiều dải ô, phương thức này chỉ trả về dải ô được chọn gần đây nhất.

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

Cầu thủ trả bóng

Range – Dải ô đang hoạt động.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getActiveRangeList()`

Trả về danh sách các dải ô đang hoạt động trong trang tính đang hoạt động hoặc null nếu không có dải ô nào đang hoạt động.

Nếu bạn chọn một dải ô, lệnh này sẽ hoạt động như một lệnh gọi getActiveRange().

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

Cầu thủ trả bóng

RangeList – Danh sách các dải ô đang hoạt động.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getActiveSheet()`

Trả về trang tính đang hoạt động trong bảng tính.

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

Cầu thủ trả bóng

Sheet — Trang tính đang hoạt động trong bảng tính.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getCurrentCell()`

Trả về ô hiện tại (được đánh dấu) được chọn ở một trong các dải ô đang hoạt động hoặc null nếu không có ô hiện tại.

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

Cầu thủ trả bóng

Range – Ô hiện tại.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getNextDataRange(direction)`

Bắt đầu từ current cell và active range và di chuyển theo hướng nhất định, trả về một phạm vi đã điều chỉnh, trong đó cạnh thích hợp của phạm vi đã được dịch chuyển để bao phủ next data cell trong khi vẫn che phủ ô hiện tại. Nếu phạm vi hoạt động không bị giới hạn dọc theo dimension của hướng, thì phạm vi hoạt động ban đầu sẽ được trả về. Nếu không có ô hoặc dải ô hiện tại nào đang hoạt động, thì null sẽ được trả về. Điều này tương đương với việc chọn một dải ô trong trình chỉnh sửa và nhấn 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());

Các tham số

Tên	Loại	Nội dung mô tả
`direction`	`Direction`	Hướng tìm ô cạnh của khu vực dữ liệu tiếp theo.

Cầu thủ trả bóng

Range – Dải ô được điều chỉnh bao gồm ô dữ liệu hoặc null nếu không có lựa chọn nào.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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