Class Range

ช่วง

ช่วงขององค์ประกอบในเอกสาร การเลือกของผู้ใช้จะแสดงเป็น Range ใน การใช้งานอื่นๆ สคริปต์จะเข้าถึงได้เฉพาะการเลือกของผู้ใช้ที่เรียกใช้สคริปต์เท่านั้น หากสคริปต์เชื่อมโยงกับเอกสาร 

// 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);
      }
    }
  }
}

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getRangeElements()RangeElement[]รับองค์ประกอบทั้งหมดใน Range นี้ รวมถึงองค์ประกอบ Text บางส่วน (เช่นในกรณี ของตัวเลือกที่มีเฉพาะบางส่วนขององค์ประกอบ Text)

เอกสารโดยละเอียด

getRangeElements()

รับองค์ประกอบทั้งหมดใน Range นี้ รวมถึงองค์ประกอบ Text บางส่วน (เช่นในกรณี ของตัวเลือกที่มีเฉพาะบางส่วนขององค์ประกอบ Text) หากต้องการตรวจสอบว่าองค์ประกอบ Text อยู่ในช่วงเพียงบางส่วนหรือไม่ โปรดดูที่ RangeElement.isPartial()

รีเทิร์น

RangeElement[] — อาร์เรย์ขององค์ประกอบตามลำดับที่ปรากฏในเอกสาร

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

วิธีการที่เลิกใช้งาน