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
दिखाता है.
रिटर्न
Integer
— Text
एलिमेंट के लिए, रेंज के आखिरी वर्ण से पहले के वर्णों की संख्या; अन्य एलिमेंट के लिए -1
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getStartOffset()
रेंज एलिमेंट के अंदर, आंशिक रेंज की शुरुआत की जगह की जानकारी देता है. अगर एलिमेंट एक Text
एलिमेंट है और isPartial()
, true
दिखाता है, तो ऑफ़सेट, रेंज की शुरुआत से पहले के वर्णों की संख्या (यानी, रेंज में पहले वर्ण का इंडेक्स) होता है. अन्य मामलों में, यह तरीका -1
दिखाता है.
रिटर्न
Integer
— Text
एलिमेंट के लिए, रेंज शुरू होने से पहले के वर्णों की संख्या; अन्य एलिमेंट के लिए, -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