Class RangeElement

Phần tửdải ô

Một trình bao bọc xung quanh Element có thể có độ dời bắt đầu và kết thúc. Các độ dời này cho phép một phạm vi ký tự trong phần tử Text được biểu thị trong kết quả tìm kiếm, lựa chọn tài liệu và phạm vi được đặt tên.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
getElement()ElementLấy Element tương ứng với RangeElement này.
getEndOffsetInclusive()IntegerLấy vị trí kết thúc của một phần dải ô trong phần tử dải ô.
getStartOffset()IntegerLấy vị trí bắt đầu của một phần phạm vi trong phần tử phạm vi.
isPartial()BooleanXác định xem phần tử dải ô này bao gồm toàn bộ phần tử hay một phần lựa chọn của các ký tự trong phần tử.

Tài liệu chi tiết

getElement()

Lấy Element tương ứng với RangeElement này. 

const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0];

// Log debug information about a range element.
Logger.log(`Element type: ${rangeElement.getElement().getType()}`);
if (rangeElement.isPartial()) {
  Logger.log(`The character range begins at ${rangeElement.getStartOffset()}`);
  Logger.log(
      `The character range ends at ${rangeElement.getEndOffsetInclusive()}`,
  );
} else {
  Logger.log('The entire range element is included.');
}

Cầu thủ trả bóng

Element – phần tử tương ứng với RangeElement này

Ủ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

getEndOffsetInclusive()

Lấy vị trí kết thúc của một phần dải ô trong phần tử dải ô. Nếu phần tử là phần tử Text và isPartial() trả về true, thì độ dời là số ký tự trước ký tự cuối cùng trong dải ô (tức là chỉ mục của ký tự cuối cùng trong dải ô); trong mọi trường hợp khác, phương thức này sẽ trả về -1.

Cầu thủ trả bóng

Integer – đối với các phần tử Text, số ký tự trước ký tự cuối cùng trong dải ô; đối với các phần tử khác, -1

Ủ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

getStartOffset()

Lấy vị trí bắt đầu của một phần phạm vi trong phần tử phạm vi. Nếu phần tử là phần tử Text và isPartial() trả về true, thì độ dời là số ký tự trước khi bắt đầu dải ô (tức là chỉ mục của ký tự đầu tiên trong dải ô); trong mọi trường hợp khác, phương thức này sẽ trả về -1.

Cầu thủ trả bóng

Integer – đối với phần tử Text, số ký tự trước khi bắt đầu dải ô; đối với các phần tử khác, -1

Ủ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

isPartial()

Xác định xem phần tử dải ô này bao gồm toàn bộ phần tử hay một phần lựa chọn của các ký tự trong phần tử. Bạn có thể xác định điểm bắt đầu và điểm kết thúc của một phần tử phạm vi bằng cách sử dụng getStartOffset() và getEndOffsetInclusive() tương ứng.

Cầu thủ trả bóng

Boolean – true nếu phần tử được đưa vào một phần; false nếu không

Ủ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