Class Selection

Lựa chọn

Truy cập vào vùng chọn hiện đang hoạt động trong trang tính đang hoạt động. Vùng chọn là tập hợp các ô 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 vùng chọn là ô hiện tại, nơi người dùng đang tập trung. Ô hiện tại được đánh dấu bằng một đường viền sẫm màu hơn trong giao diện người dùng của Google Trang tính. 

const activeSheet = SpreadsheetApp.getActiveSheet();
const rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

const 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
const ranges = selection.getActiveRangeList().getRanges();
for (let 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ứcKiểu dữ liệu trả vềMô tả ngắn
getActiveRange()Range|nullTrả về dải ô đã chọn trong trang tính đang hoạt động hoặc null nếu không có dải ô đang hoạt động.
getActiveRangeList()RangeList|nullTrả 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()SheetTrả về trang tính đang hoạt động trong bảng tính.
getCurrentCell()Range|nullTrả về ô hiện tại (được đánh dấu) được chọn trong 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|nullBắt đầu từ current cell và active range, di chuyển theo hướng đã cho, trả về một dải ô đã điều chỉnh, trong đó cạnh thích hợp của dải ô đã được dịch chuyển để bao gồm next data cell trong khi vẫn bao gồm ô 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 ô đang hoạt động. Nếu bạn chọn nhiều dải ô, phương thức này sẽ chỉ trả về dải ô được chọn gần đây nhất. 

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

Cầu thủ trả bóng

Range|null – Phạm vi hoạt động.

Ủy quyền

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

  • 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 ô duy nhất, thì thao tác này sẽ hoạt động như một lệnh gọi getActiveRange(). 

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const 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

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

  • 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 ô đang hoạt động hoặc null nếu không có ô hiện tại. 

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

Cầu thủ trả bóng

Range|null – Ô hiện tại.

Ủy quyền

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

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

getNextDataRange(direction)

Bắt đầu từ current cell và active range, di chuyển theo hướng đã cho, trả về một dải ô đã điều chỉnh, trong đó cạnh thích hợp của dải ô đã được dịch chuyển để bao gồm next data cell trong khi vẫn bao gồm ô 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ó ô hiện tại hoặc dải ô đang hoạt động, thì null sẽ được trả về. Thao tác này tương đương với việc chọn một dải ô trong trình chỉnh sửa rồi nhấn Ctrl+Shift+[arrow key]. 

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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(),
);

Thông số

TênLoạiMô tả
directionDirectionHướng tìm ô cạnh của vùng dữ liệu tiếp theo.

Cầu thủ trả bóng

Range|null – 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

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

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