Class RangeElement

RangeElement

Wrapper รอบ Element ที่มีออฟเซ็ตเริ่มต้นและสิ้นสุดที่เป็นไปได้ ออฟเซ็ตเหล่านี้ช่วยให้แสดงText องค์ประกอบที่มีช่วงอักขระภายในในผลการค้นหา การเลือกเอกสาร และช่วงที่มีชื่อได้

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getElement()Elementรับ Element ที่สอดคล้องกับ RangeElement นี้
getEndOffsetInclusive()Integerรับตำแหน่งของจุดสิ้นสุดของช่วงบางส่วนภายในองค์ประกอบช่วง
getStartOffset()Integerรับตำแหน่งของจุดเริ่มต้นของช่วงบางส่วนภายในองค์ประกอบช่วง
isPartial()Booleanกำหนดว่าองค์ประกอบช่วงนี้ครอบคลุมทั้งองค์ประกอบหรือการเลือกบางส่วนของอักขระขององค์ประกอบ

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

getElement()

รับ Element ที่สอดคล้องกับ RangeElement นี้ 

const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0];

// Log debug information about a range element.
Logger.log(`Element type: ${rangeElement.getElement().getType()}`);
if (rangeElement.isPartial()) {
  Logger.log(`The character range begins at ${rangeElement.getStartOffset()}`);
  Logger.log(
      `The character range ends at ${rangeElement.getEndOffsetInclusive()}`,
  );
} else {
  Logger.log('The entire range element is included.');
}

รีเทิร์น

Element - องค์ประกอบที่สอดคล้องกับ RangeElement นี้

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

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

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

getEndOffsetInclusive()

รับตำแหน่งของจุดสิ้นสุดของช่วงบางส่วนภายในองค์ประกอบช่วง หากองค์ประกอบเป็นองค์ประกอบ Text และ isPartial() แสดงผล true ออฟเซ็ตคือจำนวนอักขระก่อนอักขระสุดท้ายในช่วง (นั่นคือ ดัชนีของอักขระสุดท้ายในช่วง) ในกรณีอื่นๆ วิธีนี้จะแสดงผล -1

รีเทิร์น

Integer — สำหรับองค์ประกอบ Text จำนวนอักขระก่อนอักขระสุดท้ายในช่วง สำหรับองค์ประกอบอื่นๆ -1

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

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

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

getStartOffset()

รับตำแหน่งของจุดเริ่มต้นของช่วงบางส่วนภายในองค์ประกอบช่วง หากองค์ประกอบเป็นองค์ประกอบ Text และ isPartial() แสดงผล true ออฟเซ็ตคือจำนวนอักขระก่อนเริ่มต้นช่วง (นั่นคือ ดัชนีของอักขระแรกในช่วง) ในกรณีอื่นๆ เมธอดนี้จะแสดงผล -1

รีเทิร์น

Integer — สำหรับองค์ประกอบ Text จำนวนอักขระก่อนจุดเริ่มต้นของช่วง สำหรับองค์ประกอบอื่นๆ -1

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

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

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

isPartial()

กำหนดว่าองค์ประกอบช่วงนี้ครอบคลุมทั้งองค์ประกอบหรือการเลือกบางส่วนของอักขระขององค์ประกอบ คุณกำหนดจุดเริ่มต้นและจุดสิ้นสุดของช่วงขององค์ประกอบช่วงบางส่วนได้โดยใช้ getStartOffset() และ getEndOffsetInclusive() ตามลำดับ

รีเทิร์น

Boolean - true หากรวมองค์ประกอบบางส่วน false หากไม่รวม

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

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

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