Class RangeElement

RangeElement

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

Phương thức

Phương thứcKiểu 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 dải ô một phần trong phần tử dải ô.
getStartOffset()IntegerLấy vị trí bắt đầu của một dải ô một phần trong phần tử dải ô.
isPartial()BooleanXác định xem phần tử dải ô này có bao phủ toàn bộ phần tử hay chỉ một phần lựa chọn các ký tự của 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

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

getEndOffsetInclusive()

Lấy vị trí kết thúc của một dải ô một phần trong phần tử dải ô. Nếu phần tử là phần tử Text và isPartial() trả về true, thì độ lệch 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

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

getStartOffset()

Lấy vị trí bắt đầu của một dải ô một phần trong phần tử dải ô. Nếu phần tử là phần tử Text và isPartial() trả về true, thì độ lệch 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 các 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

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

isPartial()

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

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

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