Class Range

ช่วง

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

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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

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