Class RangeBuilder

RangeBuilder

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ứ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 phần tử Text vào RangeBuilder này.
addElementsBetween(startElement, endElementInclusive)RangeBuilderThê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)RangeBuilderThê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)RangeBuilderThêm nội dung của một Range khác vào RangeBuilder này.
build()RangeTạ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ê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

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

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