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