Trang này được dịch bởi Cloud Translation API.

Class RangeBuilder

Một trình tạo dùng để tạo các đối tượng Range từ các phần tử tài liệu.

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`addElement(element)`	`RangeBuilder`	Thêm toàn bộ `Element` vào `RangeBuilder` này.
`addElement(textElement, startOffset, endOffsetInclusive)`	`RangeBuilder`	Thêm một phần tử `Text` vào `RangeBuilder` này.
`addElementsBetween(startElement, endElementInclusive)`	`RangeBuilder`	Thêm hai phần tử toàn bộ và tất cả phần tử giữa hai phần tử đó vào `RangeBuilder` này.
`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`	`RangeBuilder`	Thêm hai phần tử `Text` và tất cả phần tử giữa các phần tử đó vào `RangeBuilder`.
`addRange(range)`	`RangeBuilder`	Thêm nội dung của một `Range` khác vào `RangeBuilder` này.
`build()`	`Range`	Tạo một `Range` từ các chế độ cài đặt áp dụng cho trình tạo.
`getRangeElements()`	`RangeElement[]`	Lấy tất cả phần tử trong `Range` này, bao gồm cả mọi phần tử `Text` (ví dụ: trong trường hợp lựa chọn chỉ bao gồm một phần của phần tử `Text`).

Các phương thức ngừng hoạt động

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`getSelectedElements()`	`RangeElement[]`	Lấy tất cả phần tử mà người dùng đã chọn trong phiên bản đang mở của tài liệu, bao gồm cả mọi phần tử `Text` được chọn một phần.

Tài liệu chi tiết

`addElement(element)`

Thêm toàn bộ Element vào RangeBuilder này.

Tham số

Tên	Loại	Mô tả
`element`	`Element`	phần tử cần thêm

Cầu thủ trả bóng

RangeBuilder – trình tạo 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/documents.currentonly
https://www.googleapis.com/auth/documents

`addElement(textElement, startOffset, endOffsetInclusive)`

Thêm một phần tử Text vào RangeBuilder này.

Tham số

Tên	Loại	Mô tả
`textElement`	`Text`	phần tử văn bản sẽ được thêm một phần
`startOffset`	`Integer`	số ký tự trước ký tự đầu tiên cần đưa vào (tức là chỉ mục của ký tự đầu tiên trong dải ô)
`endOffsetInclusive`	`Integer`	số ký tự trước ký tự cuối cùng cần đưa vào (tức là chỉ mục của ký tự cuối cùng trong dải ô)

Cầu thủ trả bóng

RangeBuilder – trình tạo 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/documents.currentonly
https://www.googleapis.com/auth/documents

`addElementsBetween(startElement, endElementInclusive)`

Thêm hai phần tử toàn bộ và tất cả phần tử giữa hai phần tử đó vào RangeBuilder này.

Tham số

Tên	Loại	Mô tả
`startElement`	`Element`	phần tử đầu tiên cần thêm
`endElementInclusive`	`Element`	phần tử cuối cùng được thêm

Cầu thủ trả bóng

RangeBuilder – trình tạo 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/documents.currentonly
https://www.googleapis.com/auth/documents

`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`

Thêm hai phần tử Text và tất cả phần tử giữa các phần tử đó vào RangeBuilder.

Tham số

Tên	Loại	Mô tả
`startTextElement`	`Text`	phần tử văn bản đầu tiên được thêm một phần
`startOffset`	`Integer`	số ký tự trước ký tự đầu tiên của `startTextElement` cần được đưa vào (tức là chỉ mục của ký tự đầu tiên trong dải ô)
`endTextElementInclusive`	`Text`	phần tử văn bản cuối cùng được thêm một phần
`endOffsetInclusive`	`Integer`	số ký tự trước ký tự cuối cùng của `endTextElementInclusive` cần được đưa vào (tức là chỉ mục của ký tự cuối cùng trong phạm vi)

Cầu thủ trả bóng

RangeBuilder – trình tạo 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/documents.currentonly
https://www.googleapis.com/auth/documents

`addRange(range)`

Thêm nội dung của một Range khác vào RangeBuilder này.

Tham số

Tên	Loại	Mô tả
`range`	`Range`	dải ô chứa các phần tử cần thêm

Cầu thủ trả bóng

RangeBuilder – trình tạo 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/documents.currentonly
https://www.googleapis.com/auth/documents

`build()`

Tạo một Range từ các chế độ cài đặt áp dụng cho trình tạo.

Cầu thủ trả bóng

Range – dải ô mới tạo

`getRangeElements()`

Lấy tất cả phần tử trong Range này, bao gồm cả mọi phần tử Text một phần (ví dụ: trong trường hợp lựa chọn chỉ bao gồm một phần của phần tử Text). Để xác định xem một phần tử Text chỉ có một phần nằm trong phạm vi hay không, hãy xem RangeElement.isPartial().

Cầu thủ trả bóng

RangeElement[] – một mảng các phần tử, theo thứ tự xuất hiện trong tài liệu

Ủ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/documents.currentonly
https://www.googleapis.com/auth/documents

Các phương thức ngừng hoạt động

`getSelectedElements()`

Không dùng nữa. Đổi tên thành getRangeElements().

Lấy tất cả phần tử mà người dùng đã chọn trong phiên bản mở của tài liệu, bao gồm cả mọi phần tử Text được chọn một phần.

Cầu thủ trả bóng

RangeElement[] – một mảng các phần tử đã chọn hoặc một phần được chọn, theo thứ tự xuất hiện trong tài liệu

Ủ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/documents.currentonly
https://www.googleapis.com/auth/documents