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. var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var rangeBuilder = documentTab.newRange(); var tables = documentTab.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 | 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 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 các phần tử đó vào RangeBuilder này. |
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive) | RangeBuilder | Thêm hai phần tử Text một phần 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 này
của lựa chọn chỉ bao gồm một phần của phần tử Text ). |
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
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/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.
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 đư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 bao gồm (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
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/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 các 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ầ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 yêu cầu ủy 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
một phần và tất cả cá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 sẽ được thêm một phần |
startOffset | Integer | số lượng 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 sẽ được thêm một phần |
endOffsetInclusive | Integer | số lượng 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
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 yêu cầu ủy 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 ô 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 yêu cầu ủy 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
– phạm vi mới được xây dựng
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 này
của 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
chỉ có một phần trong dải ô, hãy xem RangeElement.isPartial()
.
Cầu thủ trả bóng
RangeElement[]
— một mảng 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 yêu cầu ủy 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