Tập hợp một hoặc nhiều thực thể 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 cho các tập hợp dải ô hoặc ô không gầ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 | Ngắt 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ẻ một lần nữa. |
check() | RangeList | Thay đổi trạng thái của các hộp đánh dấu trong dải ô 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 dải ô. |
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 với các tuỳ chọn cho trước. |
clearContent() | RangeList | Xoá nội dung của từng Range trong danh sách dải ô, 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 dải ô. |
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 dải ô. |
getRanges() | Range[] | Trả về danh sách một hoặc nhiều thực thể Range trong cùng một trang tính. |
insertCheckboxes() | RangeList | Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng true nếu đã đánh dấu và false nếu đã bỏ đánh dấu. |
insertCheckboxes(checkedValue) | RangeList | Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho đã đánh dấu và một chuỗi trống nếu đã bỏ đánh dấu. |
insertCheckboxes(checkedValue, uncheckedValue) | RangeList | Chèn các hộp đánh dấu vào mỗi ô 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à đã bỏ đánh dấu. |
removeCheckboxes() | RangeList | Xoá tất cả cá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 dải ô. |
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 dải ô. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | RangeList | Đặt thuộc tính đường viền bằng màu sắc và/hoặc kiểu cho mỗi Range trong danh sách dải ô. |
setFontColor(color) | RangeList | Đặt màu phông chữ cho từng Range trong danh sách dải ô. |
setFontFamily(fontFamily) | RangeList | Đặt bộ phông chữ cho từng Range trong danh sách dải ô. |
setFontLine(fontLine) | RangeList | Đặt kiểu dòng phông chữ cho từng Range trong danh sách dải ô. |
setFontSize(size) | RangeList | Đặt kích thước phông chữ (tính bằng điểm) cho từng Range trong danh sách dải ô. |
setFontStyle(fontStyle) | RangeList | Đặt kiểu phông chữ cho từng Range trong danh sách dải ô. |
setFontWeight(fontWeight) | RangeList | Đặt độ đậm phông chữ cho từng Range trong danh sách dải ô. |
setFormula(formula) | RangeList | Cập nhật công thức cho từng Range trong danh sách dải ô. |
setFormulaR1C1(formula) | RangeList | Cập nhật công thức cho từng Range trong danh sách dải ô. |
setHorizontalAlignment(alignment) | RangeList | Đặt chế độ căn chỉnh ngang cho từng Range trong danh sách dải ô. |
setNote(note) | RangeList | Đặt văn bản ghi chú cho từng Range trong danh sách dải ô. |
setNumberFormat(numberFormat) | RangeList | Đặt định dạng số hoặc ngày cho từng Range trong danh sách dải ô. |
setShowHyperlink(showHyperlink) | RangeList | Đặt xem mỗi Range trong danh sách dải ô có hiển thị siêu liên kết hay không. |
setTextDirection(direction) | RangeList | Thiết lập hướng văn bản cho các ô trong mỗi Range thuộc danh sách dải ô. |
setTextRotation(degrees) | RangeList | Đặt chế độ 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 cách căn chỉnh dọc cho từng Range trong danh sách dải ô. |
setVerticalText(isVertical) | RangeList | Thiết lập xem có nên xếp chồng văn bản cho các ô cho mỗi Range trong danh sách dải ô hay không. |
setWrap(isWrapEnabled) | RangeList | Đặt xuống dòng tự động cho từng Range trong danh sách dải ô. |
setWrapStrategy(strategy) | RangeList | Đặt chiến lược xuống dòng tự động cho từng Range trong danh sách dải ô. |
trimWhitespace() | RangeList | Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ 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 dải ô 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
. Dải ô cuối cùng trong danh sách được đặt là active range
.
Lưu ý: Thao tác này mang đến cách để chọn nhiều dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Cầu thủ trả bóng
RangeList
– Danh sách các dải ô đang hoạt động để tạo chuỗ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
breakApart()
Ngắt 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ẻ một lần nữa.
Việc gọi hàm này trên 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 > Hủy hợp nhất Trang tính.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
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 bỏ đá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'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
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 dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
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 với các tuỳ chọn cho trước. Theo mặc định, mọi dữ liệu đều 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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear({contentsOnly: true});
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
options | Object | Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây. |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
commentsOnly | Boolean | Liệu có chỉ xoá nhận xét hay không. |
contentsOnly | Boolean | Liệu có chỉ xoá nội dung hay không. |
formatOnly | Boolean | Liệu có chỉ xoá định dạng hay không; xin 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 | Liệu có chỉ xoá quy tắc xác thực dữ liệu hay không. |
skipFilteredRows | Boolean | Liệu có tránh xoá các hàng đã lọc hay không. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
clearContent()
Xoá nội dung của từng Range
trong danh sách dải ô, giữ nguyên định dạng.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
clearDataValidations()
Xoá các quy tắc xác thực dữ liệu cho từng Range
trong danh sách dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
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.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
clearNote()
Xoá ghi chú cho từng Range
trong danh sách dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
getRanges()
Trả về danh sách 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 dả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
insertCheckboxes()
Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng true
nếu đã đánh dấu và false
nếu đã bỏ đánh dấu. Đặt giá trị của mọi ô trong dải ô thành false
.
var 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 dải ô này để tạo chuỗ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
insertCheckboxes(checkedValue)
Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho đã đánh dấu và một chuỗi trống nếu đã bỏ đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành chuỗi trống.
var 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');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
checkedValue | Object | Giá trị đã chọn cho xác thực dữ liệu hộp kiểm. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
insertCheckboxes(checkedValue, uncheckedValue)
Chèn các hộp đánh dấu vào mỗi ô 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à đã bỏ đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh được bỏ đánh dấu.
var 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');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
checkedValue | Object | Giá trị đã chọn cho xác thực dữ liệu hộp kiểm. |
uncheckedValue | Object | Giá trị đã bỏ đánh dấu để xác thực dữ liệu hộp đánh dấu. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
removeCheckboxes()
Xoá tất cả các hộp đánh dấu khỏi dải ô. Xoá tính năng xác thực dữ liệu của từng ô và xoá thêm giá trị của ô đó nếu ô chứa giá trị đã đánh dấu hoặc đã bỏ đánh dấu.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var 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(); var 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 dải ô này để tạo chuỗ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
setBackground(color)
Đặt màu nền cho từng Range
trong danh sách dải ô. Màu được biểu thị trong ký hiệu CSS; ví dụ: '#ffffff'
hoặc 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | Mã màu nền trong ký hiệu CSS như '#ffffff' hoặc 'white' ; giá trị null sẽ đặt lại màu. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
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 xung quanh lệnh gọi setBackground(color)
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); // Sets the background to red for each range in the range list. rangeList.setBackgroundRGB(255, 0, 0);
Các tham số
Tên | Loại | Nội dung 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 dải ô này để tạo chuỗ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
setBorder(top, left, bottom, right, vertical, horizontal)
Đặt thuộc tính đường viền cho mỗi Range
trong danh sách dải ô. Các giá trị hợp lệ là true
(bật), false
(tắt) và null
(không thay đổi).
var sheet = SpreadsheetApp.getActiveSheet(); var 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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
top | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
left | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
bottom | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
right | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
vertical | Boolean | true cho đường viền dọc nội bộ, false cho không có, null không thay đổi. |
horizontal | Boolean | true cho đường viền ngang nội bộ, false cho không có, null nếu không thay đổi. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Đặt thuộc tính đường viền bằng màu sắc và/hoặc kiểu cho mỗi Range
trong danh sách dải ô.
Các giá trị hợp lệ là true
(bật), false
(tắt) và null
(không thay đổi). Màu sắc được biểu thị bằng ký hiệu CSS; ví dụ: '#ffffff'
hoặc 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var 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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
top | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
left | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
bottom | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
right | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
vertical | Boolean | true cho đường viền dọc nội bộ, false cho không có, null không thay đổi. |
horizontal | Boolean | true cho đường viền ngang nội bộ, false cho không có, null nếu không thay đổi. |
color | String | Màu đường viền trong ký hiệu CSS như '#ffffff' hoặc 'white' , null cho màu mặc định (đen). |
style | BorderStyle | Kiểu đường viền, null cho kiểu mặc định (đồng nhất). |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setFontColor(color)
Đặt màu phông chữ cho từng Range
trong danh sách dải ô. Màu sắc được biểu thị trong ký hiệu CSS; ví dụ: '#ffffff'
hoặc 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | Màu phông chữ trong ký hiệu CSS như '#ffffff' hoặc 'white' ; giá trị null sẽ đặt lại màu sắc. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setFontFamily(fontFamily)
Đặt bộ phông chữ cho từng Range
trong danh sách dải ô. Bộ phông chữ được mô tả bằng một giá trị nhận dạng chuỗi như Arial
hoặc Roboto
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Các tham số
Tên | Loại | Nội dung 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 dải ô này để tạo chuỗ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
setFontLine(fontLine)
Đặt kiểu dòng phông chữ cho từng Range
trong danh sách dải ô. Các tuỳ chọn kiểu đường kẻ là 'underline'
, 'line-through'
hoặc 'none'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontLine | String | Kiểu dòng phông chữ, 'underline' , 'line-through' hoặc 'none' ; giá trị null sẽ đặt lại kiểu dòng phông chữ. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setFontSize(size)
Đặt kích thước phông chữ (tính bằng điểm) cho từng Range
trong danh sách dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
size | Integer | Một cỡ chữ. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setFontStyle(fontStyle)
Đặt kiểu phông chữ cho từng Range
trong danh sách dải ô. Các tuỳ chọn kiểu phông chữ là 'italic'
hoặc 'normal'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle("italic");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontStyle | String | Kiểu phông chữ, '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 dải ô này để tạo chuỗ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
setFontWeight(fontWeight)
Đặt độ đậm phông chữ cho từng Range
trong danh sách dải ô. Các tuỳ chọn độ đậm phông chữ là 'normal'
hoặc 'bold'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontWeight | String | Độ đậm phông chữ, 'bold' hoặc 'normal' ; giá trị null sẽ đặt lại độ đậm phông chữ. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setFormula(formula)
Cập nhật công thức cho từng Range
trong danh sách dải ô. Công thức đã cho phải ở dạng ký hiệu A1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formula | String | Một chuỗi đại diện cho công thức cần đặt. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setFormulaR1C1(formula)
Cập nhật công thức cho từng Range
trong danh sách dải ô. Công thức đã cho phải ở dạng ký hiệu R1C1.
var sheet = SpreadsheetApp.getActiveSheet(); var 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])');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formula | String | Công thức chuỗi. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setHorizontalAlignment(alignment)
Đặt chế độ căn chỉnh ngang cho từng Range
trong danh sách dải ô. Các tuỳ chọn căn chỉnh là 'left'
, 'center'
hoặc 'right'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setHorizontalAlignment("center");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
alignment | String | Cách căn chỉnh, 'left' , 'center' hoặc 'normal' ; giá trị null sẽ đặt lại cách căn chỉnh. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setNote(note)
Đặt văn bản ghi chú cho từng Range
trong danh sách dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setNote('This is a note');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
note | String | Văn bản ghi chú cần thiết lập; giá trị null sẽ xoá ghi chú. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setNumberFormat(numberFormat)
Đặt định dạng số hoặc ngày cho từng Range
trong danh sách dải ô.
Các mẫu định dạng được chấp nhận được mô tả trong Hướng dẫn định dạng số và ngày trong API Trang tính.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Always show 3 decimal points for the specified ranges. rangeList.setNumberFormat('0.000');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
numberFormat | String | Chuỗi định dạng số. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setShowHyperlink(showHyperlink)
Đặt xem mỗi Range
trong danh sách dải ô có hiển thị siêu liên kết hay không.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Show hyperlinks for all the ranges. rangeList.setShowHyperlink(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
showHyperlink | Boolean | Có hiển thị siêu liên kết hay không. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setTextDirection(direction)
Thiết lập hướng văn bản cho các ô trong mỗi Range
thuộc danh sách dải ô. Nếu một hướng được chỉ định là null
, thì hướng sẽ được dự đoán rồi đặt.
// Sets right-to-left text direction each range in the range list. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
direction | TextDirection | Hướng văn bản mong muốn; nếu null thì hướng được dự đoán trước khi đặt. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setTextRotation(degrees)
Đặt chế độ xoay văn bản cho các ô trong mỗi Range
trong danh sách dải ô. Dữ liệu đầu vào tương ứng với góc giữa hướng văn bản chuẩn và hướng mong muốn. Giá trị đầu vào là 0 cho biết văn bản được đặt theo hướng chuẩn.
Đối với hướng văn bản từ trái sang phải, các góc dương sẽ ngược chiều kim đồng hồ, còn đối với văn bản từ phải sang trái thì theo chiều kim đồng hồ.
// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
Các tham số
Tên | Loại | Nội dung 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 ngược chiều kim đồng hồ. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
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 '=' thì giá trị này được hiểu là một công thức.
var sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | Object | Giá trị của dải ô. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setVerticalAlignment(alignment)
Đặt cách căn chỉnh dọc cho từng Range
trong danh sách dải ô. Các tuỳ chọn căn chỉnh là 'top'
, 'middle'
hoặc 'bottom'
.
// Sets the vertical alignment to middle for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment("middle");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
alignment | String | Cách căn chỉnh, 'top' , 'middle' hoặc 'bottom' ; giá trị null sẽ đặt lại cách căn chỉnh. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setVerticalText(isVertical)
Thiết lập xem có nên xếp chồng văn bản cho các ô cho mỗi 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 độ sẽ bị bỏ qua.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
isVertical | Boolean | Liệu có nên xếp chồng văn bản hay không. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setWrap(isWrapEnabled)
Đặt xuống dòng tự động cho từng Range
trong danh sách dải ô. Các ô đã bật tính năng bao bọc có thể thay đổi kích thước để hiển thị toàn bộ nội dung của chúng. Các ô bị vô hiệu hoá tính năng bao bọc sẽ hiển thị nhiều nhất có thể trong ô mà không cần đổi kích thước hoặc chạy nhiều dòng.
// Enable text wrap for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
isWrapEnabled | Boolean | Có nên xuống dòng tự động hay không. |
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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
setWrapStrategy(strategy)
Đặt chiến lược xuống dòng tự động cho từng Range
trong danh sách dải ô.
// Sets the list of ranges to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Các tham số
Tên | Loại | Nội dung 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 dải ô này để tạo chuỗ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
trimWhitespace()
Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) trong mỗi ô trong danh sách dải ô này. Xoá mọi khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi phần con của các ký tự khoảng trắng còn lại thành một dấu cách.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']); var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); var 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 dải ô này để tạo chuỗ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
Xem thêm
uncheck()
Thay đổi trạng thái của 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 bỏ đánh dấu.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'unchecked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Cầu thủ trả bóng
RangeList
– Danh sách dải ô này để tạo chuỗ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