Class Range

Phạm vi

Một loạt các phần tử trong một tài liệu. Lựa chọn của người dùng được biểu thị dưới dạng Range, trong số mục đích sử dụng khác. Tập lệnh chỉ có thể truy cập vào lựa chọn người dùng đang chạy tập lệnh và chỉ nếu tập lệnh bị ràng buộc với tài liệu.

// Bold all selected text.
var selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  var elements = selection.getRangeElements();
  for (var i = 0; i < elements.length; i++) {
    var element = elements[i];

    // Only modify elements that can be edited as text; skip images and other non-text elements.
    if (element.getElement().editAsText) {
      var text = element.getElement().editAsText();

      // Bold the selected part of the element, or the full element if it's completely selected.
      if (element.isPartial()) {
        text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true);
      } else {
        text.setBold(true);
      }
    }
  }
}

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
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

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