Class RangeElement

องค์ประกอบช่วง

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

เมธอด

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

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

getElement()

รับ Element ที่ตรงกับ RangeElement นี้ 

// 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