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 ). |
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()
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