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

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