Class Selection

Lựa chọn

Truy cập vào lựa chọn đang hoạt động hiện tại trong trang tính đang hoạt động. Lựa 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 lựa 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 đường viền đậm hơn trong giao diện người dùng 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 ô đ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 rồi 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 chuyển để bao phủ next data cell trong khi vẫ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 ô đang hoạt động. Nếu 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. 

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

Cầu thủ trả bóng

Range|null – 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 uỷ quyền bằng 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 ô đang hoạt động.

Nếu chỉ có một dải ô được chọn, thì phương thứ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

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

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

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng 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 ô đ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

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng 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 rồi 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 chuyển để bao phủ next data cell trong khi vẫn bao phủ ô hiện tại. Nếu dải ô đang hoạt động không bị giới hạn dọc theo dimension của hướng, thì dải ô đang 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ề. Đ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.
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(),
);

Tham 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 ô đã đ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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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