Class RangeBuilder

RangeBuilder

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

// Change the user's selection to a range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var 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	दो आंशिक Text एलिमेंट और उनके बीच के सभी एलिमेंट को RangeBuilder में जोड़ता है.
addRange(range)	RangeBuilder	इस RangeBuilder में दूसरे Range का कॉन्टेंट जोड़ता है.
build()	Range	बिल्डर पर लागू की गई सेटिंग से Range बनाता है.
getRangeElements()	RangeElement[]	इस Range के सभी एलिमेंट की जानकारी देता है. इनमें, कुछ हद तक Text एलिमेंट शामिल हैं. उदाहरण के लिए, अगर किसी विकल्प में Text एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें.

काम न करने वाले तरीके

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

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

addElement(element)

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

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

---

addElement(textElement, startOffset, endOffsetInclusive)

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

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

---

addElementsBetween(startElement, endElementInclusive)

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

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

---

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

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

पैरामीटर

नाम	Type	ब्यौरा
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 का कॉन्टेंट जोड़ता है.

पैरामीटर

नाम	Type	ब्यौरा
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