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 phép toán trên tập hợp các ô hoặc dải ô không liền kề.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
activate() | Range | Chọn danh sách các thực thể Range . |
break | Range | Chia lại 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() | Range | 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() | Range | 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) | Range | 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 tuỳ chọn đã cho. |
clear | Range | Xoá nội dung của từng Range trong danh sách dải ô, giữ nguyên định dạng. |
clear | Range | Xoá quy tắc xác thực dữ liệu cho từng Range trong danh sách dải ô. |
clear | Range | Xoá định dạng văn bản cho mỗi Range trong danh sách dải ô. |
clear | Range | Xoá ghi chú cho mỗi Range trong danh sách dải ô. |
get | Range[] | Trả về danh sách một hoặc nhiều thực thể Range trong cùng một trang tính. |
insert | Range | Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho ô đã đánh dấu và false cho ô chưa đánh dấu. |
insert | Range | Chèn hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng một giá trị tuỳ chỉnh cho ô đã đánh dấu và chuỗi trống cho ô chưa đánh dấu. |
insert | Range | Chèn 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à chưa đánh dấu. |
remove | Range | Xoá tất cả hộp đánh dấu khỏi dải ô. |
set | Range | Đặt màu nền cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt nền thành màu RGB đã cho. |
set | Range | Đặt thuộc tính đường viền cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt thuộc tính đường viền bằng màu và/hoặc kiểu cho mỗi Range trong danh sách phạm vi. |
set | Range | Đặt màu phông chữ cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt bộ phông chữ cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt kiểu đường phông chữ cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt cỡ chữ (tính bằng điểm) cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt kiểu phông chữ cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt độ đậm phông chữ cho mỗi Range trong danh sách dải ô. |
set | Range | Cập nhật công thức cho mỗi Range trong danh sách dải ô. |
set | Range | Cập nhật công thức cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt chế độ căn chỉnh theo chiều ngang cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt văn bản ghi chú cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt định dạng số hoặc ngày cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt xem mỗi Range trong danh sách phạm vi có hiển thị siêu liên kết hay không. |
set | Range | Đặt hướng văn bản cho các ô trong mỗi Range trong danh sách dải ô. |
set | Range | Đặt chế độ cài đặt xoay văn bản cho các ô trong mỗi Range trong danh sách dải ô. |
set | Range | Đặt giá trị cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt cách căn chỉnh dọc cho mỗi Range trong danh sách dải ô. |
set | Range | Đặt xem có xếp chồng văn bản cho các ô cho mỗi Range trong danh sách phạm vi hay không. |
set | Range | Đặt chế độ ngắt dòng cho từng Range trong danh sách dải ô. |
set | Range | Đặt chiến lược xuống dòng văn bản cho mỗi Range trong danh sách dải ô. |
trim | Range | Cắt bỏ 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() | Range | 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
. Phạm vi cuối cùng trong danh sách được đặt thành active range
.
Lưu ý: Đây là cách để 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
Range
– Danh sách các dải ô đang hoạt động, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
break Apart()
Chia lại 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 danh sách dải ô tương đương với việc chọn một tập hợp dải ô rồi chọn mục Format > Merge > Unmerge (Định dạng > Hợp nhất > Huỷ hợp nhất) trên trình đơn Trang tính.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 phạm vi.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 bằng các tuỳ 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});
Tham 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ả |
---|---|---|
comments | Boolean | Liệu có chỉ xoá các nhận xét hay không. |
contents | Boolean | Liệu có chỉ xoá nội dung hay không. |
format | Boolean | Liệu chỉ xoá đị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. |
validations | Boolean | Liệu có chỉ xoá các quy tắc xác thực dữ liệu hay không. |
skip | Boolean | Liệu có nên tránh xoá các hàng đã lọc hay không. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 Content()
Xoá nội dung của từng Range
trong danh sách dải ô, 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 Data Validations()
Xoá quy tắc xác thực dữ liệu cho từng Range
trong danh sách dải ô.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 Format()
Xoá định dạng văn bản cho mỗi 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 Note()
Xoá ghi chú cho mỗi Range
trong danh sách dải ô.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get Ranges()
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 các dải ô.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
insert Checkboxes()
Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true
cho ô đã đánh dấu và false
cho ô 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
insert Checkboxes(checkedValue)
Chèn hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
checked | Object | Giá trị đã chọn cho quy tắc xác thực dữ liệu hộp đánh dấu. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
insert Checkboxes(checkedValue, uncheckedValue)
Chèn 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à chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh chưa đá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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
checked | Object | Giá trị đã chọn cho quy tắc xác thực dữ liệu hộp đánh dấu. |
unchecked | Object | Giá trị không được đánh dấu cho quy trình xác thực dữ liệu hộp đánh dấu. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
remove Checkboxes()
Xoá tất cả hộp đánh dấu khỏi dải ô. Xoá tính năng xác thực dữ liệu của mỗi ô và 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Background(color)
Đặt màu nền cho mỗi Range
trong danh sách dả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(['A:A', 'C:C']); rangeList.setBackground('red');
Tham 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Background RGB(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 set
.
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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
red | Integer | Giá trị màu đỏ theo ký hiệu RGB. |
green | Integer | Giá trị màu xanh lục theo ký hiệu RGB. |
blue | Integer | Giá trị màu xanh dương theo ký hiệu RGB. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Border(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).
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);
Tham 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 có thay đổi. |
left | Boolean | true cho đường viền, false cho không có đường viền, null cho không có thay đổi. |
bottom | Boolean | true cho đường viền, false cho không có đường viền, null cho không có thay đổi. |
right | Boolean | true cho đường viền, false cho không có đường viền, null cho không có 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 nội bộ, false cho không có đường viền, null cho không có thay đổi. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Border(top, left, bottom, right, vertical, horizontal, color, style)
Đặt thuộc tính đường viền bằng 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, );
Tham 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 có thay đổi. |
left | Boolean | true cho đường viền, false cho không có đường viền, null cho không có thay đổi. |
bottom | Boolean | true cho đường viền, false cho không có đường viền, null cho không có thay đổi. |
right | Boolean | true cho đường viền, false cho không có đường viền, null cho không có 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 nội bộ, false cho không có đường viền, null cho không có 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 | Border | Kiểu cho đường viền, null cho kiểu mặc định (đường liền). |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Font Color(color)
Đặt màu phông chữ cho mỗi Range
trong danh sách dả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(['A:A', 'C:C']); rangeList.setFontColor('red');
Tham số
Tên | Loại | 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. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Font Family(fontFamily)
Đặt bộ phông chữ cho mỗi Range
trong danh sách dải ô. Bộ phông chữ được mô tả bằng 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
font | 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Font Line(fontLine)
Đặt kiểu đường phông chữ cho mỗi Range
trong danh sách dải ô. Các tuỳ chọn 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
font | String | Kiểu đường phông chữ, 'underline' , 'line-through' hoặc 'none' ; giá trị null sẽ đặt lại kiểu đường phông chữ. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Font Size(size)
Đặt cỡ chữ (tính bằng điểm) cho mỗi Range
trong danh sách dải ô.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Tham số
Tên | Loại | Mô tả |
---|---|---|
size | Integer | Kích thước điểm phông chữ. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Font Style(fontStyle)
Đặt kiểu phông chữ cho mỗi Range
trong danh sách dải ô. Các tuỳ chọn 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
font | 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Font Weight(fontWeight)
Đặt độ đậm phông chữ cho mỗi Range
trong danh sách dải ô. Các tuỳ chọn độ đậ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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
font | 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Formula(formula)
Cập nhật công thức cho mỗi Range
trong danh sách dải ô. Công thức đã cho phải ở dạng ký hiệu A1.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Tham số
Tên | Loại | 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Formula R1C1(formula)
Cập nhật công thức cho mỗi Range
trong danh sách dải ô. Công thức đã cho phải ở dạng 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])');
Tham số
Tên | Loại | Mô tả |
---|---|---|
formula | String | Công thức chuỗi. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Horizontal Alignment(alignment)
Đặt chế độ căn chỉnh theo chiều ngang cho mỗi Range
trong danh sách dải ô. Các tuỳ 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
alignment | String | Căn chỉnh, 'left' , 'center' hoặc 'normal' ; giá trị null sẽ đặt lại căn chỉnh. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Note(note)
Đặt văn bản ghi chú cho mỗi Range
trong danh sách dải ô.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setNote('This is a note');
Tham 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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Number Format(numberFormat)
Đặt định dạng số hoặc ngày cho mỗi 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 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
number | String | Chuỗi định dạng số. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Show Hyperlink(showHyperlink)
Đặt xem mỗi Range
trong danh sách phạm vi có 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
show | Boolean | Liệu có hiển thị siêu liên kết hay không. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Text Direction(direction)
Đặt hướng văn bản cho các ô trong mỗi Range
trong danh sách dải ô. Nếu hướng được chỉ định là null
, thì hướng sẽ được suy luận và sau đó được đặ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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
direction | Text | Hướng văn bản mong muốn; nếu null , hướng sẽ được suy luận trước khi đặt. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Text Rotation(degrees)
Đặt chế độ cài đặt xoay văn bản cho các ô trong mỗi Range
trong danh sách dải ô. Giá trị đầ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. Giá trị đầu vào bằng 0 cho biết văn bản được đặt thành 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 sẽ theo hướng ngược chiều kim đồng hồ, còn đối với hướng từ phải sang trái, các góc dương sẽ theo hướng 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
degrees | Integer | Góc mong muốn giữa hướng tiêu 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 chiều kim đồng hồ. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Value(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ì chuỗi đó sẽ được diễn giải 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
value | Object | Giá trị cho dải ô. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Vertical Alignment(alignment)
Đặt cách căn chỉnh dọc cho mỗi 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. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment('middle');
Tham số
Tên | Loại | Mô tả |
---|---|---|
alignment | String | Căn chỉnh, 'top' , 'middle' hoặc 'bottom' ; giá trị null sẽ đặt lại căn chỉnh. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Vertical Text(isVertical)
Đặt xem có xếp chồng văn bản cho các ô cho mỗi Range
trong danh sách phạm vi 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. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Tham số
Tên | Loại | Mô tả |
---|---|---|
is | Boolean | Có xếp chồng văn bản hay không. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Wrap(isWrapEnabled)
Đặt chế độ ngắt dòng cho từng Range
trong danh sách dải ô. Các ô có tính năng gói được bật sẽ đổi kích thước để hiển thị toàn bộ nội dung. Các ô đã tắt tính năng tự độ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 sang 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
is | Boolean | Có xuống dòng văn bản hay không. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set Wrap Strategy(strategy)
Đặt chiến lược xuống dòng văn bản cho mỗi Range
trong danh sách dải ô.
// 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
strategy | Wrap | Chiến lược xuống dòng mong muốn. |
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
trim Whitespace()
Cắt bỏ 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 rút gọn mọi trình tự con của các ký tự khoảng trắng còn lại thành một dấu cách.
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
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 "bỏ đá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 'unchecked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Cầu thủ trả bóng
Range
– Danh sách dải ô này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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