Class RangeBuilder

RangeBuilder

Trình tạo dùng để tạo các đối tượng Range từ các phần tử trong 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ứcKiểu 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 một phần vào RangeBuilder này.
addElementsBetween(startElement, endElementInclusive)RangeBuilderThêm hai phần tử hoàn chỉnh và tất cả các phần tử giữa chúng vào RangeBuilder này.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderThêm hai phần tử Text một phần và tất cả các phần tử ở giữa chúng 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 được á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.

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, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 một phần 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 được đư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 đượ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, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addElementsBetween(startElement, endElementInclusive)

Thêm hai phần tử hoàn chỉnh và tất cả các phần tử giữa chúng 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 vào

Cầu thủ trả bóng

RangeBuilder – trình tạo này, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 chúng vào RangeBuilder.

Tham số

TênLoạiMô tả
startTextElementTextphần tử văn bản đầu tiên cần được thêm một phần
startOffsetIntegersố 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 phạm vi)
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, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 ô có các phần tử cần được thêm

Cầu thủ trả bóng

RangeBuilder – trình tạo này, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được áp dụng cho trình tạo.

Cầu thủ trả bóng

Range – dãy núi mới 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 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 đưa vào một phần 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

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