Class RangeList

Danh sáchphạm vi

Một tập hợp gồm một hoặc nhiều phiên bản Range trong cùng một trang tính. Bạn có thể sử dụng lớp này để áp dụng các thao tác trên các tập hợp gồm các ô hoặc dải ô không liền kề.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
activate()	RangeList	Chọn danh sách các thực thể Range.
breakApart()	RangeList	Tách tất cả các ô được hợp nhất theo chiều ngang hoặc chiều dọc có trong danh sách dải ô thành các ô riêng lẻ.
check()	RangeList	Thay đổi trạng thái của các hộp đánh dấu trong phạm vi thành "đã đánh dấu".
clear()	RangeList	Xoá phạm vi nội dung, định dạng và quy tắc xác thực dữ liệu cho từng Range trong danh sách phạm vi.
clear(options)	RangeList	Xoá phạm vi nội dung, định dạng, quy tắc xác thực dữ liệu và nhận xét, như được chỉ định bằng các lựa chọn đã cho.
clearContent()	RangeList	Xoá nội dung của từng Range trong danh sách phạm vi, giữ nguyên định dạng.
clearDataValidations()	RangeList	Xoá các quy tắc xác thực dữ liệu cho từng Range trong danh sách phạm vi.
clearFormat()	RangeList	Xoá định dạng văn bản cho từng Range trong danh sách dải ô.
clearNote()	RangeList	Xoá ghi chú cho từng Range trong danh sách phạm vi.
getRanges()	Range[]	Trả về danh sách gồm một hoặc nhiều thực thể Range trong cùng một trang tính.
insertCheckboxes()	RangeList	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho trạng thái đã đánh dấu và false cho trạng thái chưa đánh dấu.
insertCheckboxes(checkedValue)	RangeList	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho ô đã đánh dấu và chuỗi trống cho ô chưa đánh dấu.
insertCheckboxes(checkedValue, uncheckedValue)	RangeList	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng các giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và chưa đánh dấu.
removeCheckboxes()	RangeList	Xoá tất cả hộp đánh dấu khỏi dải ô.
setBackground(color)	RangeList	Đặt màu nền cho từng Range trong danh sách phạm vi.
setBackgroundRGB(red, green, blue)	RangeList	Đặt nền thành màu RGB đã cho.
setBorder(top, left, bottom, right, vertical, horizontal)	RangeList	Đặt thuộc tính đường viền cho mỗi Range trong danh sách phạm vi.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)	RangeList	Đặt thuộc tính đường viền theo màu và/hoặc kiểu cho mỗi Range trong danh sách phạm vi.
setFontColor(color)	RangeList	Đặt màu phông chữ cho từng Range trong danh sách phạm vi.
setFontFamily(fontFamily)	RangeList	Đặt họ phông chữ cho từng Range trong danh sách phạm vi.
setFontLine(fontLine)	RangeList	Đặt kiểu đường kẻ phông chữ cho từng Range trong danh sách phạm vi.
setFontSize(size)	RangeList	Đặt cỡ chữ (tính bằng điểm) cho từng Range trong danh sách phạm vi.
setFontStyle(fontStyle)	RangeList	Đặt kiểu phông chữ cho từng Range trong danh sách phạm vi.
setFontWeight(fontWeight)	RangeList	Đặt độ đậm của phông chữ cho mỗi Range trong danh sách phạm vi.
setFormula(formula)	RangeList	Cập nhật công thức cho từng Range trong danh sách phạm vi.
setFormulaR1C1(formula)	RangeList	Cập nhật công thức cho từng Range trong danh sách phạm vi.
setHorizontalAlignment(alignment)	RangeList	Đặt chế độ căn chỉnh ngang cho từng Range trong danh sách phạm vi.
setNote(note)	RangeList	Đặt văn bản ghi chú cho từng Range trong danh sách phạm vi.
setNumberFormat(numberFormat)	RangeList	Đặt định dạng số hoặc ngày cho mỗi Range trong danh sách phạm vi.
setShowHyperlink(showHyperlink)	RangeList	Đặt xem mỗi Range trong danh sách phạm vi có nên hiển thị siêu liên kết hay không.
setTextDirection(direction)	RangeList	Đặt hướng văn bản cho các ô trong mỗi Range trong danh sách phạm vi.
setTextRotation(degrees)	RangeList	Đặt chế độ cài đặt xoay văn bản cho các ô trong mỗi Range trong danh sách dải ô.
setValue(value)	RangeList	Đặt giá trị cho mỗi Range trong danh sách dải ô.
setVerticalAlignment(alignment)	RangeList	Đặt chế độ căn chỉnh dọc cho từng Range trong danh sách phạm vi.
setVerticalText(isVertical)	RangeList	Đặt xem có xếp chồng văn bản cho các ô cho từng Range trong danh sách dải ô hay không.
setWrap(isWrapEnabled)	RangeList	Đặt chế độ xuống dòng tự động cho từng Range trong danh sách phạm vi.
setWrapStrategy(strategy)	RangeList	Đặt chiến lược xuống dòng tự động cho từng Range trong danh sách phạm vi.
trimWhitespace()	RangeList	Cắt khoảng trắng (chẳng hạn như dấu cách, dấu tab hoặc dòng mới) trong mọi ô trong danh sách dải ô này.
uncheck()	RangeList	Thay đổi trạng thái của các hộp đánh dấu trong phạm vi thành "chưa đánh dấu".

Tài liệu chi tiết

activate()

Chọn danh sách các thực thể Range. Phạm vi cuối cùng trong danh sách được đặt làm active range.

Lưu ý: Thao tác này cho phép bạn chọn nhiều dải ô.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

Cầu thủ trả bóng

RangeList – Danh sách các dải ô đang hoạt động, để liên kết.

Ủ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

---

breakApart()

Tách tất cả các ô được hợp nhất theo chiều ngang hoặc chiều dọc có trong danh sách dải ô thành các ô riêng lẻ.

Việc gọi hàm này trên một danh sách dải ô tương đương với việc chọn một tập hợp dải ô và chọn mục trong trình đơn Định dạng > Hợp nhất > Huỷ hợp nhất của Trang tính.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

check()

Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "đã đánh dấu". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc chưa đánh dấu được định cấu hình.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'checked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

clear()

Xoá phạm vi nội dung, định dạng và quy tắc xác thực dữ liệu cho từng Range trong danh sách phạm vi.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

clear(options)

Xoá phạm vi nội dung, định dạng, quy tắc xác thực dữ liệu và nhận xét, như được chỉ định bằng các lựa chọn đã cho. Theo mặc định, tất cả dữ liệu sẽ bị xoá.

// The code below clears the contents of the following ranges A:A and C:C in the
// active sheet, but preserves the format, data validation rules, and comments.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Thông số

Tên	Loại	Mô tả
options	Object	Một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới.

Thông số nâng cao

Tên	Loại	Mô tả
commentsOnly	Boolean	Chọn xem có chỉ xoá bình luận hay không.
contentsOnly	Boolean	Có xoá nội dung hay không.
formatOnly	Boolean	Có xoá chỉ định dạng hay không; lưu ý rằng việc xoá định dạng cũng sẽ xoá các quy tắc xác thực dữ liệu.
validationsOnly	Boolean	Có xoá chỉ các quy tắc xác thực dữ liệu hay không.
skipFilteredRows	Boolean	Có nên tránh xoá các hàng đã lọc hay không.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

clearContent()

Xoá nội dung của từng Range trong danh sách phạm vi, giữ nguyên định dạng.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

clearDataValidations()

Xoá các quy tắc xác thực dữ liệu cho từng Range trong danh sách phạm vi.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

clearFormat()

Xoá định dạng văn bản cho từng Range trong danh sách dải ô.

Thao tác này sẽ xoá định dạng văn bản cho từng dải ô nhưng không đặt lại bất kỳ quy tắc định dạng số nào.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

clearNote()

Xoá ghi chú cho từng Range trong danh sách phạm vi.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

getRanges()

Trả về danh sách gồm một hoặc nhiều thực thể Range trong cùng một trang tính.

Cầu thủ trả bóng

Range[] – Danh sách các dả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

---

insertCheckboxes()

Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho trạng thái đã đánh dấu và false cho trạng thái chưa đánh dấu. Đặt giá trị của tất cả các ô trong dải ô thành false.

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'true' for checked and 'false' for unchecked. Also, sets the value of each
// cell in the ranges D4 and E6 to 'false'.
rangeList.insertCheckboxes();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

insertCheckboxes(checkedValue)

Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho ô đã đánh dấu và chuỗi trống cho ô chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành chuỗi trống.

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and the empty string for unchecked. Also, sets the value of
// each cell in the ranges D4 and E6 to the empty string.
rangeList.insertCheckboxes('yes');

Thông số

Tên	Loại	Mô tả
checkedValue	Object	Giá trị đã chọn cho quy tắc xác thực dữ liệu của hộp kiểm.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

insertCheckboxes(checkedValue, uncheckedValue)

Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng các giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh chưa được đánh dấu.

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and 'no' for unchecked. Also, sets the value of each cell
// in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

Thông số

Tên	Loại	Mô tả
checkedValue	Object	Giá trị đã chọn cho quy tắc xác thực dữ liệu của hộp kiểm.
uncheckedValue	Object	Giá trị chưa được đánh dấu cho xác thực dữ liệu hộp kiểm.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

removeCheckboxes()

Xoá tất cả hộp đánh dấu khỏi dải ô. Xoá quy tắc xác thực dữ liệu của từng ô, đồng thời xoá giá trị của ô nếu ô đó chứa giá trị đã đánh dấu hoặc chưa đánh dấu.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their
// value.
rangeList1.removeCheckboxes();

const rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear
// their value.
rangeList2.removeCheckboxes();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setBackground(color)

Đặt màu nền cho từng Range trong danh sách phạm vi. Màu được biểu thị bằng ký hiệu CSS; ví dụ: '#ffffff' hoặc 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

Thông số

Tên	Loại	Mô tả
color	String	Mã màu nền theo ký hiệu CSS, chẳng hạn như '#ffffff' hoặc 'white'; giá trị null sẽ đặt lại màu.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setBackgroundRGB(red, green, blue)

Đặt nền thành màu RGB đã cho. Đây là một trình bao bọc tiện lợi cho lệnh gọi setBackground(color).

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

Thông số

Tên	Loại	Mô tả
red	Integer	Giá trị màu đỏ trong ký hiệu RGB.
green	Integer	Giá trị màu xanh lục trong ký hiệu RGB.
blue	Integer	Giá trị màu xanh dương trong ký hiệu RGB.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setBorder(top, left, bottom, right, vertical, horizontal)

Đặt thuộc tính đường viền cho mỗi Range trong danh sách phạm vi. Các giá trị hợp lệ là true (bật), false (tắt) và null (không thay đổi).

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves
// the left and right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

Thông số

Tên	Loại	Mô tả
top	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
left	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
bottom	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
right	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
vertical	Boolean	true cho đường viền dọc bên trong, false cho không có đường viền, null cho không có thay đổi.
horizontal	Boolean	true cho đường viền ngang bên trong, false cho không có đường viền, null cho không có thay đổi.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Đặt thuộc tính đường viền theo màu và/hoặc kiểu cho mỗi Range trong danh sách phạm vi. Các giá trị hợp lệ là true (bật), false (tắt) và null (không thay đổi). Màu được biểu thị bằng ký hiệu CSS; ví dụ: '#ffffff' hoặc 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged
// of the ranges A2:B4 and C1:D4. Also sets the color to 'red', and the border
// to 'DASHED'.
rangeList.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

Thông số

Tên	Loại	Mô tả
top	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
left	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
bottom	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
right	Boolean	true cho đường viền, false cho không có đường viền, null cho không thay đổi.
vertical	Boolean	true cho đường viền dọc bên trong, false cho không có đường viền, null cho không có thay đổi.
horizontal	Boolean	true cho đường viền ngang bên trong, false cho không có đường viền, null cho không có thay đổi.
color	String	Màu đường viền theo ký hiệu CSS, chẳng hạn như '#ffffff' hoặc 'white', null cho màu mặc định (đen).
style	BorderStyle	Kiểu cho đường viền, null cho kiểu mặc định (rắn).

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFontColor(color)

Đặt màu phông chữ cho từng Range trong danh sách phạm vi. Màu được biểu thị bằng ký hiệu CSS; ví dụ: '#ffffff' hoặc 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

Thông số

Tên	Loại	Mô tả
color	String	Màu phông chữ theo ký hiệu CSS, chẳng hạn như '#ffffff' hoặc 'white'; giá trị null sẽ đặt lại màu.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFontFamily(fontFamily)

Đặt họ phông chữ cho từng Range trong danh sách phạm vi. Bộ phông chữ được mô tả bằng một giá trị nhận dạng chuỗi, chẳng hạn như Arial hoặc Roboto.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

Thông số

Tên	Loại	Mô tả
fontFamily	String	Bộ phông chữ cần đặt; giá trị null sẽ đặt lại bộ phông chữ.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFontLine(fontLine)

Đặt kiểu đường kẻ phông chữ cho từng Range trong danh sách phạm vi. Các lựa chọn về kiểu đường kẻ là 'underline', 'line-through' hoặc 'none'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

Thông số

Tên	Loại	Mô tả
fontLine	String	Kiểu đường kẻ của phông chữ, có thể là 'underline', 'line-through' hoặc 'none'; giá trị null sẽ đặt lại kiểu đường kẻ của phông chữ.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFontSize(size)

Đặt cỡ chữ (tính bằng điểm) cho từng Range trong danh sách phạm vi.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

Thông số

Tên	Loại	Mô tả
size	Integer	Cỡ phông chữ tính bằng điểm.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFontStyle(fontStyle)

Đặt kiểu phông chữ cho từng Range trong danh sách phạm vi. Các lựa chọn về kiểu phông chữ là 'italic' hoặc 'normal'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle('italic');

Thông số

Tên	Loại	Mô tả
fontStyle	String	Kiểu phông chữ, có thể là 'italic' hoặc 'normal'; giá trị null sẽ đặt lại kiểu phông chữ.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFontWeight(fontWeight)

Đặt độ đậm của phông chữ cho mỗi Range trong danh sách phạm vi. Các lựa chọn về độ đậm của phông chữ là 'normal' hoặc 'bold'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

Thông số

Tên	Loại	Mô tả
fontWeight	String	Độ đậm của phông chữ, có thể là 'bold' hoặc 'normal'; giá trị null sẽ đặt lại độ đậm của phông chữ.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFormula(formula)

Cập nhật công thức cho từng Range trong danh sách phạm vi. Công thức đã cho phải ở ký hiệu A1.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

Thông số

Tên	Loại	Mô tả
formula	String	Một chuỗi biểu thị công thức cần đặt.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setFormulaR1C1(formula)

Cập nhật công thức cho từng Range trong danh sách phạm vi. Công thức đã cho phải ở ký hiệu R1C1.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Thông số

Tên	Loại	Mô tả
formula	String	Công thức chuỗi.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setHorizontalAlignment(alignment)

Đặt chế độ căn chỉnh ngang cho từng Range trong danh sách phạm vi. Các lựa chọn căn chỉnh là 'left', 'center' hoặc 'right'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment('center');

Thông số

Tên	Loại	Mô tả
alignment	String	Vị trí căn chỉnh, có thể là 'left', 'center' hoặc 'normal'; giá trị null sẽ đặt lại vị trí căn chỉnh.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setNote(note)

Đặt văn bản ghi chú cho từng Range trong danh sách phạm vi.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

Thông số

Tên	Loại	Mô tả
note	String	Văn bản ghi chú cần đặt; giá trị null sẽ xoá ghi chú.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setNumberFormat(numberFormat)

Đặt định dạng số hoặc ngày cho mỗi Range trong danh sách phạm vi.

Các mẫu định dạng được chấp nhận được mô tả trong hướng dẫn định dạng ngày và số của API Trang tính.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Thông số

Tên	Loại	Mô tả
numberFormat	String	Một chuỗi định dạng số.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setShowHyperlink(showHyperlink)

Đặt xem mỗi Range trong danh sách phạm vi có nên hiển thị siêu liên kết hay không.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

Thông số

Tên	Loại	Mô tả
showHyperlink	Boolean	Có hiện siêu liên kết hay không.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setTextDirection(direction)

Đặt hướng văn bản cho các ô trong mỗi Range trong danh sách phạm vi. Nếu hướng được chỉ định là null, thì hướng sẽ được suy luận rồi đặt.

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Thông số

Tên	Loại	Mô tả
direction	TextDirection	Hướng văn bản mong muốn; nếu null hướng được suy luận trước khi đặt.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setTextRotation(degrees)

Đặt chế độ cài đặt xoay văn bản cho các ô trong mỗi Range trong danh sách dải ô. Đầu vào tương ứng với góc giữa hướng văn bản tiêu chuẩn và hướng mong muốn. Đầu vào bằng 0 cho biết văn bản được đặt ở hướng tiêu chuẩn.

Đối với hướng văn bản từ trái sang phải, các góc dương theo hướng ngược chiều kim đồng hồ, trong khi đối với hướng văn bản từ phải sang trái, các góc dương theo hướng chiều kim đồng hồ.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

Thông số

Tên	Loại	Mô tả
degrees	Integer	Góc mong muốn giữa hướng chuẩn và hướng mong muốn. Đối với văn bản từ trái sang phải, các góc dương nằm theo hướng ngược chiều kim đồng hồ.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setValue(value)

Đặt giá trị cho mỗi Range trong danh sách dải ô. Giá trị có thể là số, chuỗi, boolean hoặc ngày. Nếu bắt đầu bằng dấu "=", thì giá trị đó sẽ được hiểu là một công thức.

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

Thông số

Tên	Loại	Mô tả
value	Object	Giá trị cho phạm vi.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setVerticalAlignment(alignment)

Đặt chế độ căn chỉnh dọc cho từng Range trong danh sách phạm vi. Các lựa chọn căn chỉnh là 'top', 'middle' hoặc 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

Thông số

Tên	Loại	Mô tả
alignment	String	Vị trí căn chỉnh, có thể là 'top', 'middle' hoặc 'bottom'; giá trị null sẽ đặt lại vị trí căn chỉnh.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setVerticalText(isVertical)

Đặt xem có xếp chồng văn bản cho các ô cho từng Range trong danh sách dải ô hay không. Nếu văn bản được xếp chồng theo chiều dọc, thì chế độ cài đặt xoay văn bản theo độ sẽ bị bỏ qua.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

Thông số

Tên	Loại	Mô tả
isVertical	Boolean	Có xếp chồng văn bản hay không.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setWrap(isWrapEnabled)

Đặt chế độ xuống dòng tự động cho từng Range trong danh sách phạm vi. Các ô có tính năng xuống dòng được bật sẽ thay đổi kích thước để hiển thị toàn bộ nội dung. Các ô không bật tính năng xuống dòng sẽ hiển thị nhiều nội dung nhất có thể trong ô mà không cần đổi kích thước hoặc chạy thành nhiều dòng.

// Enable text wrap for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

Thông số

Tên	Loại	Mô tả
isWrapEnabled	Boolean	Có xuống dòng tự động hay không.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

setWrapStrategy(strategy)

Đặt chiến lược xuống dòng tự động cho từng Range trong danh sách phạm vi.

// Sets the list of ranges to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Thông số

Tên	Loại	Mô tả
strategy	WrapStrategy	Chiến lược xuống dòng mong muốn.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

---

trimWhitespace()

Cắt khoảng trắng (chẳng hạn như dấu cách, dấu tab hoặc dòng mới) trong mọi ô trong danh sách dải ô này. Xoá tất cả khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi chuỗi con của các ký tự khoảng trắng còn lại thành một khoảng trắng duy nhất.

Lưu ý: Nếu văn bản được cắt bớt thu được bắt đầu bằng ký tự "+" hoặc "=", thì văn bản vẫn là giá trị chuỗi và không được diễn giải là công thức.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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

Xem thêm

• Range.trimWhitespace()

---

uncheck()

Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "chưa đánh dấu". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc chưa đánh dấu nào được định cấu hình.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'unchecked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Cầu thủ trả bóng

RangeList – Danh sách phạm vi này, để liên kết.

Ủ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