Class Selection

Lựa chọn

Truy cập vào lựa chọn hiện đang hoạt động trong trang tính đang hoạt động. Vùng lựa chọn là tập hợp các ô mà người dùng được đánh dấu trong trang tính, đây có thể là các dải ô không gần nhau. Một ô trong vùng 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 đánh dấu bằng đường viền đậm 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ứcLoại dữ liệu trả vềMô tả ngắn
getActiveRange()RangeTrả về dải ô đã chọn trong trang tính đang hoạt động hoặc null nếu không có dải ô hoạt động.
getActiveRangeList()RangeListTrả về danh sách 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 dải ô.
getActiveSheet()SheetTrả về trang tính đang hoạt động trong bảng tính.
getCurrentCell()RangeTrả về ô hiện tại (được đánh dấu) được chọn trong một trong các dải ô hoạt động hoặc null nếu không có ô hiện tại.
getNextDataRange(direction)RangeBắt đầu từ current cellactive range và di chuyển theo hướng đã cho, sẽ trả về một dải ô được điều chỉnh theo cạnh thích hợp của phạm vi đã được dịch chuyển để bao gồm next data cell khi vẫn đứng yên bao 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 ô hoạt động. Nếu nhiều dải ô đã được chọn, 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 yêu cầu ủy 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 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 dải ô.

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

Tham số

TênLoạiMô tả
directionDirectionHướng tìm ô cạnh của khu vực lưu trữ 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ó ô nào lựa chọn.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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