Class RangeElement

RangeElement

Element के चारों ओर रैपर, जिसके शुरू और खत्म होने की फ़्रीक्वेंसी संभव है. इन ऑफ़सेट की मदद से, Text एलिमेंट में मौजूद वर्णों की रेंज को खोज के नतीजों, दस्तावेज़ चुनने, और नाम वाली रेंज में दिखाने की अनुमति मिलती है.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getElement()Elementइस RangeElement से जुड़ा Element मिलता है.
getEndOffsetInclusive()Integerरेंज एलिमेंट में पार्शियल रेंज के आखिरी एलिमेंट की पोज़िशन बताता है.
getStartOffset()Integerरेंज एलिमेंट के अंदर, आंशिक रेंज की शुरुआत की जगह की जानकारी देता है.
isPartial()Booleanइससे पता चलता है कि यह रेंज एलिमेंट पूरे एलिमेंट को कवर करता है या एलिमेंट के वर्णों का कुछ हिस्सा.

ज़्यादा जानकारी के साथ दस्तावेज़

getElement()

इस RangeElement से जुड़ा Element मिलता है.

// 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 से जुड़ा है

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

getEndOffsetInclusive()

रेंज एलिमेंट में पार्शियल रेंज के आखिरी एलिमेंट की पोज़िशन बताता है. अगर एलिमेंट एक Text एलिमेंट है और isPartial() true दिखाता है, तो ऑफ़सेट, रेंज में आखिरी वर्ण से पहले के वर्णों की संख्या (यानी, रेंज के आखिरी वर्ण का इंडेक्स) होता है. अन्य किसी मामले में, यह तरीका -1 दिखाता है.

रिटर्न

IntegerText एलिमेंट के लिए, रेंज के आखिरी वर्ण से पहले के वर्णों की संख्या; अन्य एलिमेंट के लिए -1

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

getStartOffset()

रेंज एलिमेंट के अंदर, आंशिक रेंज की शुरुआत की जगह की जानकारी देता है. अगर एलिमेंट एक Text एलिमेंट है और isPartial(), true दिखाता है, तो ऑफ़सेट, रेंज की शुरुआत से पहले के वर्णों की संख्या (यानी, रेंज में पहले वर्ण का इंडेक्स) होता है. अन्य मामलों में, यह तरीका -1 दिखाता है.

रिटर्न

IntegerText एलिमेंट के लिए, रेंज शुरू होने से पहले के वर्णों की संख्या; अन्य एलिमेंट के लिए, -1

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

isPartial()

इससे पता चलता है कि यह रेंज एलिमेंट पूरे एलिमेंट को कवर करता है या एलिमेंट के वर्णों का कुछ हिस्सा. आंशिक रेंज एलिमेंट की रेंज की शुरुआत और आखिर की जानकारी को क्रम से getStartOffset() और getEndOffsetInclusive() का इस्तेमाल करके तय किया जा सकता है.

रिटर्न

Boolean — अगर एलिमेंट का कुछ हिस्सा शामिल किया गया है, तो true. अगर एलिमेंट का कुछ हिस्सा शामिल नहीं है, तो false

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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