Class RangeBuilder

RangeBuilder

यह बिल्डर, दस्तावेज़ के एलिमेंट से Range ऑब्जेक्ट बनाने के लिए इस्तेमाल किया जाता है.

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
addElement(element)	RangeBuilder	इस RangeBuilder में पूरा Element जोड़ता है.
addElement(textElement, startOffset, endOffsetInclusive)	RangeBuilder	इस RangeBuilder में, Text एलिमेंट का कुछ हिस्सा जोड़ता है.
addElementsBetween(startElement, endElementInclusive)	RangeBuilder	इस RangeBuilder में दो पूरे एलिमेंट और उनके बीच के सभी एलिमेंट जोड़ता है.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)	RangeBuilder	यह RangeBuilder में दो आंशिक Text एलिमेंट और उनके बीच के सभी एलिमेंट जोड़ता है.
addRange(range)	RangeBuilder	इस RangeBuilder में, किसी अन्य Range का कॉन्टेंट जोड़ता है.
build()	Range	यह बिल्डर पर लागू की गई सेटिंग से Range बनाता है.
getRangeElements()	RangeElement[]	इस Range में मौजूद सभी एलिमेंट मिलते हैं. इनमें कुछ हिस्से वाले Text एलिमेंट भी शामिल हैं. उदाहरण के लिए, अगर किसी Text एलिमेंट का सिर्फ़ कुछ हिस्सा चुना गया है, तो उस मामले में.

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
getSelectedElements()	RangeElement[]	यह फ़ंक्शन, दस्तावेज़ के खुले इंस्टेंस में उपयोगकर्ता की ओर से चुने गए सभी एलिमेंट को दिखाता है. इनमें आंशिक रूप से चुने गए Text एलिमेंट भी शामिल हैं.

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

addElement(element)

इस RangeBuilder में पूरा Element जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
element	Element	जोड़ा जाने वाला एलिमेंट

वापसी का टिकट

RangeBuilder — यह बिल्डर, चेन बनाने के लिए है

अनुमति देना

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

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

---

addElement(textElement, startOffset, endOffsetInclusive)

इस RangeBuilder में, Text एलिमेंट का कुछ हिस्सा जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
textElement	Text	टेक्स्ट एलिमेंट का वह हिस्सा जिसे जोड़ा जाना है
startOffset	Integer	शामिल किए जाने वाले पहले वर्ण से पहले के वर्णों की संख्या (यानी, रेंज में मौजूद पहले वर्ण का इंडेक्स)
endOffsetInclusive	Integer	शामिल किए जाने वाले आखिरी वर्ण से पहले के वर्णों की संख्या (यानी, रेंज में मौजूद आखिरी वर्ण का इंडेक्स)

वापसी का टिकट

RangeBuilder — यह बिल्डर, चेन बनाने के लिए है

अनुमति देना

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

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

---

addElementsBetween(startElement, endElementInclusive)

इस RangeBuilder में दो पूरे एलिमेंट और उनके बीच के सभी एलिमेंट जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
startElement	Element	जोड़ा जाने वाला पहला एलिमेंट
endElementInclusive	Element	जोड़ा जाने वाला आखिरी एलिमेंट

वापसी का टिकट

RangeBuilder — यह बिल्डर, चेन बनाने के लिए है

अनुमति देना

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

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

---

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

यह RangeBuilder में दो आंशिक Text एलिमेंट और उनके बीच के सभी एलिमेंट जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
startTextElement	Text	यह पहला टेक्स्ट एलिमेंट है जिसे आंशिक रूप से जोड़ा जाना है
startOffset	Integer	startTextElement के पहले वर्ण से पहले के वर्णों की संख्या, जिन्हें शामिल करना है. इसका मतलब है कि रेंज में पहले वर्ण का इंडेक्स
endTextElementInclusive	Text	वह आखिरी टेक्स्ट एलिमेंट जिसे कुछ हद तक जोड़ा गया है
endOffsetInclusive	Integer	endTextElementInclusive के आखिरी वर्ण से पहले के वर्णों की संख्या, जिन्हें शामिल करना है. इसका मतलब है कि रेंज में आखिरी वर्ण का इंडेक्स

वापसी का टिकट

RangeBuilder — यह बिल्डर, चेन बनाने के लिए है

अनुमति देना

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

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

---

addRange(range)

इस RangeBuilder में, किसी अन्य Range का कॉन्टेंट जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
range	Range	वह रेंज जिसके एलिमेंट जोड़े जाने चाहिए

वापसी का टिकट

RangeBuilder — यह बिल्डर, चेन बनाने के लिए है

अनुमति देना

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

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

---

build()

यह बिल्डर पर लागू की गई सेटिंग से Range बनाता है.

वापसी का टिकट

Range — नई रेंज

---

getRangeElements()

इस Range में मौजूद सभी एलिमेंट मिलते हैं. इनमें कुछ हिस्से वाले Text एलिमेंट भी शामिल हैं. उदाहरण के लिए, अगर किसी Text एलिमेंट का सिर्फ़ कुछ हिस्सा चुना गया है, तो उस मामले में. यह तय करने के लिए कि कोई Text एलिमेंट, रेंज में सिर्फ़ कुछ हद तक शामिल है या नहीं, RangeElement.isPartial() देखें.

वापसी का टिकट

RangeElement[] — एलिमेंट का एक कलेक्शन, जिसमें एलिमेंट उसी क्रम में होते हैं जिस क्रम में वे दस्तावेज़ में दिखते हैं

अनुमति देना

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

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

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

getSelectedElements()

अब सेवा में नहीं है. नाम बदलकर getRangeElements() कर दिया गया है.

यह फ़ंक्शन, दस्तावेज़ के खुले इंस्टेंस में उपयोगकर्ता की ओर से चुने गए सभी एलिमेंट को दिखाता है. इनमें आंशिक रूप से चुने गए Text एलिमेंट भी शामिल हैं.

वापसी का टिकट

RangeElement[] — चुने गए या आंशिक रूप से चुने गए एलिमेंट का कलेक्शन. ये एलिमेंट, दस्तावेज़ में दिखने के क्रम में होते हैं

अनुमति देना

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

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