Class RangeList

RangeList

Một tập hợp gồm 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 học này để áp dụng các thao tác trên tập hợp dải ô hoặc ô không gần nhau.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
activate()RangeListChọn danh sách các thực thể Range.
breakApart()RangeListChia tất cả các ô được hợp nhất theo chiều ngang hoặc chiều dọc nằm trong danh sách dải ô thành từng ô riêng lẻ.
check()RangeListThay đổi trạng thái của hộp đánh dấu trong dải ô thành "đã đánh dấu".
clear()RangeListXoá phạm vi nội dung, định dạng và quy tắc xác thực dữ liệu cho mỗi Range trong danh sách dải ô.
clear(options)RangeListXoá 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.
clearContent()RangeListXoá nội dung của từng Range trong danh sách dải ô, giữ nguyên định dạng.
clearDataValidations()RangeListXoá quy tắc xác thực dữ liệu cho từng Range trong danh sách dải ô.
clearFormat()RangeListXoá định dạng văn bản của từng Range trong danh sách dải ô.
clearNote()RangeListXoá 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()RangeListChèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho các ô đã đánh dấu và Bỏ đánh dấu false.
insertCheckboxes(checkedValue)RangeListChèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng một giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và chuỗi trống để bỏ đánh dấu.
insertCheckboxes(checkedValue, uncheckedValue)RangeListChè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 ô đã đánh dấu và các trạng thái chưa đánh dấu.
removeCheckboxes()RangeListXoá 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 dải ô.
setBackgroundRGB(red, green, blue)RangeListĐặt nền thành màu RGB đã cho.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListThiết lập thuộc tính đường viền cho từng Range trong danh sách dải ô.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListThiết lập thuộc tính đường viền bằng màu 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 mỗi 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 cỡ 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)RangeListCập nhật công thức cho từng Range trong danh sách dải ô.
setFormulaR1C1(formula)RangeListCập nhật công thức cho từng Range trong danh sách dải ô.
setHorizontalAlignment(alignment)RangeListĐặt cách căn chỉnh ngang cho từng Range trong danh sách dải ô.
setNote(note)RangeListThiết lập 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 định dạng ngày cho từng Range trong danh sách dải ô.
setShowHyperlink(showHyperlink)RangeListThiết lập 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)RangeListThiết lập hướng văn bản cho các ô trong mỗi Range trong danh sách dải ô.
setTextRotation(degrees)RangeListThiết lập 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Đặt xem có xếp chồng văn bản cho các ô cho mỗi Range trong dải ô hay không danh sách.
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()RangeListCắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) ở mọi ô trong danh sách dải ô này.
uncheck()RangeListThay đổi trạng thái của các hộp đánh dấu trong dải ô thành "đã bỏ chọn".

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 thành active range.

Lưu ý: Đây là 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 yêu cầu ủy 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()

Chia tất cả các ô được hợp nhất theo chiều ngang hoặc chiều dọc nằm trong danh sách dải ô thành từng ô 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 các dải ô và chọn Format (Định dạng) > Hợp nhất > Huỷ hợp nhất mục trong trình đơn 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 yêu cầu ủy 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 bỏ đánh dấu đã đị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 yêu cầu ủy 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 mỗi 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 yêu cầu ủy 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 đề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});

Tham số

TênLoạiMô tả
optionsObjectĐố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ênLoạiMô tả
commentsOnlyBooleanLiệu có chỉ xoá bình luận hay không.
contentsOnlyBooleanLiệu có chỉ xoá nội dung hay không.
formatOnlyBooleanLiệu có chỉ xoá định dạng hay không; Xin lưu ý rằng việc xoá cũng xoá các quy tắc xác thực dữ liệu.
validationsOnlyBooleanLiệu có chỉ xoá quy tắc xác thực dữ liệu hay không.
skipFilteredRowsBooleanLiệ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 yêu cầu ủy 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 yêu cầu ủy 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á 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 yêu cầu ủy 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 của 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 yêu cầu ủy 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 yêu cầu ủy 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 các dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho các ô đã đánh dấu và Bỏ đánh dấu false. Đặt giá trị của tất cả các ô 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 yêu cầu ủy 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 hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng một giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và chuỗi trống để 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');

Tham số

TênLoạiMô tả
checkedValueObjectGiá trị được đánh dấu để xác thực dữ liệu của 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 yêu cầu ủy 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 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 ô đã đánh dấu và các trạng thái chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh không đá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');

Tham số

TênLoạiMô tả
checkedValueObjectGiá trị được đánh dấu để xác thực dữ liệu của hộp đánh dấu.
uncheckedValueObjectGiá trị không được chọn cho việc 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 yêu cầu ủy 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ả hộp đánh dấu khỏi dải ô. Xoá thông tin xác thực dữ liệu của từng ô, và sẽ xoá thêm giá trị 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 yêu cầu ủy 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 thể hiện bằng 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');

Tham số

TênLoạiMô tả
colorStringMã 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 yêu cầu ủy 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);

Tham số

TênLoạiMô tả
redIntegerGiá trị màu đỏ trong ký hiệu RGB.
greenIntegerGiá trị màu xanh lục trong ký hiệu RGB.
blueIntegerGiá 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 yêu cầu ủy 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)

Thiết lập thuộc tính đường viền cho từng 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);

Tham số

TênLoạiMô tả
topBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
leftBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
bottomBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
rightBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
verticalBooleantrue cho đường viền dọc bên trong, false để không thay đổi, null để không thay đổi.
horizontalBooleantrue cho đường viền ngang bên trong, false cho đường viền không có, null để 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 yêu cầu ủy 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)

Thiết lập thuộc tính đường viền bằng màu 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 là được trình bày 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);

Tham số

TênLoạiMô tả
topBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
leftBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
bottomBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
rightBooleantrue cho đường viền, false để không thay đổi, null để không thay đổi.
verticalBooleantrue cho đường viền dọc bên trong, false để không thay đổi, null để không thay đổi.
horizontalBooleantrue cho đường viền ngang bên trong, false cho đường viền không có, null để không thay đổi.
colorStringMàu đường viền trong ký hiệu CSS như '#ffffff' hoặc 'white', null cho màu mặc định (đen).
styleBorderStyleKiểu đường viền, null cho kiểu mặc định (cố đị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 yêu cầu ủy 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 được thể hiện trong CSS ký hiệu; ví dụ: '#ffffff' hoặc 'white'.

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

Tham số

TênLoạiMô tả
colorStringMàu phông chữ trong ký hiệu CSS như '#ffffff' hoặc 'white'; một Giá trị null đặ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 yêu cầu ủy 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 mỗi Range trong danh sách dải ô. Bộ phông chữ được mô tả theo một giá trị nhận dạng kiểu chuỗi như Arial hoặc Roboto.

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

Tham số

TênLoạiMô tả
fontFamilyStringBộ 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 yêu cầu ủy 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 ô. Lựa 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');

Tham số

TênLoạiMô tả
fontLineStringKiểu dòng phông chữ, 'underline', 'line-through' hoặc 'none'; một giá trị null đặ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 yêu cầu ủy 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 cỡ 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);

Tham số

TênLoạiMô tả
sizeIntegerCỡ 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 yêu cầu ủy 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 ô. Lựa 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");

Tham số

TênLoạiMô tả
fontStyleStringKiểu phông chữ 'italic' hoặc 'normal'; một 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 yêu cầu ủy 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 về độ đậm phông chữ là 'normal' hoặc 'bold'.

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

Tham số

TênLoạiMô tả
fontWeightStringĐộ đậm phông chữ, 'bold' hoặc 'normal'; một 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 yêu cầu ủy 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 ở Ký hiệu A1.

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

Tham số

TênLoạiMô tả
formulaStringMộ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 yêu cầu ủy 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 ở 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])');

Tham số

TênLoạiMô tả
formulaStringCô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 yêu cầu ủy 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 cách căn chỉnh ngang cho từng Range trong danh sách dải ô. 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");

Tham số

TênLoạiMô tả
alignmentStringCách căn chỉnh, 'left', 'center' hoặc 'normal'; một Giá trị null đặt lại 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 yêu cầu ủy 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)

Thiết lập 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');

Tham số

TênLoạiMô tả
noteStringVă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 dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 định dạng 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 của 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');

Tham số

TênLoạiMô tả
numberFormatStringChuỗ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 yêu cầu ủy 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

Thiết lập 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);

Tham số

TênLoạiMô tả
showHyperlinkBooleanLiệu 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 yêu cầu ủy 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 trong danh sách dải ô. Nếu một hướng đã chỉ định là null, hướng này sẽ được suy ra 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);

Tham số

TênLoạiMô tả
directionTextDirectionHướng văn bản mong muốn; nếu null, hướng được suy luận trước cài đặ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 yêu cầu ủy 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)

Thiết lập chế độ xoay văn bản cho các ô trong mỗi Range trong danh sách dải ô. Chiến lược phát hành đĩa đơn đầ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 hướng. Giá trị nhập bằng 0 cho biết văn bản được đặt theo hướng chuẩn.

Để hướng văn bản từ trái sang phải, các góc dương là ngược chiều kim đồng hồ, còn từ phải sang trái thì xoay 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);

Tham số

TênLoạiMô tả
degreesIntegerGó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 sẽ 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 yêu cầu ủy 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 tháng. Nếu dòng chữ bắt đầu bằng '=' nó đượ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);

Tham số

TênLoạiMô tả
valueObjectGiá trị cho 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 yêu cầu ủy 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 ô. 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");

Tham số

TênLoạiMô tả
alignmentStringCách căn chỉnh, 'top', 'middle' hoặc 'bottom'; một Giá trị null đặt lại 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 yêu cầu ủy 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)

Đặt xem có xếp chồng văn bản cho các ô cho mỗi Range trong dải ô hay không danh sách. Nếu văn bản được xếp chồng theo chiều dọc, 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);

Tham số

TênLoạiMô tả
isVerticalBooleanLiệu có 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 yêu cầu ủy 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 đổi kích thước có thể bao bọc để hiển thị toàn bộ nội dung. Các ô bị tắt tính năng ngắt dòng hiển thị nhiều 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

Tham số

TênLoạiMô tả
isWrapEnabledBooleanCó gói 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 yêu cầu ủy 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);

Tham số

TênLoạiMô tả
strategyWrapStrategyChiế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 yêu cầu ủy 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) ở mọi ô trong danh sách dải ô này. Xóa tất cả khoảng trắng ở phần đầu và phần cuối văn bản của mỗi ô và giảm mọi thứ tự sau đó ký tự khoảng trắng còn lại thành một khoảng trắng.

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 yêu cầu ủy 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 các hộp đánh dấu trong dải ô thành "đã bỏ chọn". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc bỏ đánh dấu đã đị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'.
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 yêu cầu ủy 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