Class Range

Phạm vi

Một dải ô trong 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ố các mục đích sử dụng khác. Tập lệnh chỉ có thể truy cập vào lựa chọn của người dùng đang chạy tập lệnh và chỉ khi tập lệnh được liên kết với tài liệu.

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

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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ứcKiểu 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 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 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