दस्तावेज़ एलिमेंट से 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 एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें. |
ज़्यादा जानकारी के साथ दस्तावेज़
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()
getRangeElements()
इस Range
के सभी एलिमेंट की जानकारी देता है. इनमें, कुछ हद तक Text
एलिमेंट शामिल हैं. उदाहरण के लिए, अगर किसी विकल्प में Text
एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें. यह पता करने के लिए कि कोई Text
एलिमेंट, रेंज में सिर्फ़ कुछ हद तक शामिल है या नहीं, RangeElement.isPartial()
देखें.
रिटर्न
RangeElement[]
— एलिमेंट का कलेक्शन, जिस क्रम में दस्तावेज़ में दिखता है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents