Class RangeElement

RangeElement

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

अनुमति देना

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

  • 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