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

Class RangeBuilder

Trình tạo dùng để tạo đố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 document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Phương thức

Phương thức	Kiểu 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 phần tử `Text` vào `RangeBuilder` này.
`addElementsBetween(startElement, endElementInclusive)`	`RangeBuilder`	Thêm toàn bộ hai phần tử và tất cả các phần tử ở giữa vào `RangeBuilder` này.
`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`	`RangeBuilder`	Thêm 2 phần tử `Text` và tất cả cá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 `Range` từ các chế độ cài đặt áp dụng cho trình tạo.
`getRangeElements()`	`RangeElement[]`	Lấy tất cả cá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`).

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

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`getSelectedElements()`	`RangeElement[]`	Lấy tất cả các phần tử mà người dùng đã chọn trong thực thể đ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.

Các tham số

Tên	Loại	Nội dung 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

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

`addElement(textElement, startOffset, endOffsetInclusive)`

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

Các tham số

Tên	Loại	Nội dung mô tả
`textElement`	`Text`	thành phần văn bản cần được thêm một phần
`startOffset`	`Integer`	số lượng ký tự trước ký tự đầu tiên cần đưa vào (nghĩa là chỉ mục của ký tự đầu tiên trong dải ô)
`endOffsetInclusive`	`Integer`	số lượng ký tự trước ký tự cuối cùng cần đưa vào (nghĩa 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

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

`addElementsBetween(startElement, endElementInclusive)`

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

Các tham số

Tên	Loại	Nội dung mô tả
`startElement`	`Element`	phần tử đầu tiên cần thêm vào
`endElementInclusive`	`Element`	phần tử cuối cùng cần thêm

Cầu thủ trả bóng

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

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

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

Các tham số

Tên	Loại	Nội dung mô tả
`startTextElement`	`Text`	thành phần văn bản đầu tiên cầ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 (nghĩa là chỉ mục của ký tự đầu tiên trong dải ô)
`endTextElementInclusive`	`Text`	thành phần văn bản cuối cùng cần đượ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 đưa vào (nghĩa 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

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/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.

Các tham số

Tên	Loại	Nội dung mô tả
`range`	`Range`	dải ô có các phần tử cần được thêm vào

Cầu thủ trả bóng

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

`build()`

Tạo 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 được tạo

`getRangeElements()`

Lấy tất cả cá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 phần tử Text có chỉ được đưa vào một phần trong dải ô 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

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/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ả các phần tử mà người dùng đã chọn trong thực thể đ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.

Cầu thủ trả bóng

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

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