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

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