Class RangeBuilder

Trình tạodải ô

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ứcLoại dữ liệu trả vềMô tả ngắn
addElement(element)RangeBuilderThêm toàn bộ Element vào RangeBuilder này.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderThêm một phần tử Text vào RangeBuilder này.
addElementsBetween(startElement, endElementInclusive)RangeBuilderThê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)RangeBuilderThê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)RangeBuilderThêm nội dung của một Range khác vào RangeBuilder này.
build()RangeTạ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 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.

Tham số

TênLoạiMô tả
elementElementphầ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ênLoạiMô tả
textElementTextphần tử văn bản sẽ được thêm một phần
startOffsetIntegersố 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 ô)
endOffsetInclusiveIntegersố 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ênLoạiMô tả
startElementElementphần tử đầu tiên cần thêm
endElementInclusiveElementphầ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ênLoạiMô tả
startTextElementTextphần tử văn bản đầu tiên được thêm một phần
startOffsetIntegersố 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 ô)
endTextElementInclusiveTextphần tử văn bản cuối cùng được thêm một phần
endOffsetInclusiveIntegersố 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ênLoạiMô tả
rangeRangedả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