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 एलिमेंट का सिर्फ़ कुछ हिस्सा चुना गया है, तो उस मामले में.

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

addElement(element)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

addElement(textElement, startOffset, endOffsetInclusive)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

addElementsBetween(startElement, endElementInclusive)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

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

पैरामीटर

नामटाइपब्यौरा
startTextElementTextयह पहला टेक्स्ट एलिमेंट है जिसे आंशिक रूप से जोड़ा जाना है
startOffsetIntegerstartTextElement के पहले वर्ण से पहले के वर्णों की संख्या, जिन्हें शामिल करना है. इसका मतलब है कि रेंज में पहले वर्ण का इंडेक्स
endTextElementInclusiveTextवह आखिरी टेक्स्ट एलिमेंट जिसे कुछ हद तक जोड़ा गया है
endOffsetInclusiveIntegerendTextElementInclusive के आखिरी वर्ण से पहले के वर्णों की संख्या, जिन्हें शामिल करना है. इसका मतलब है कि रेंज में आखिरी वर्ण का इंडेक्स

वापसी का टिकट

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

अनुमति देना

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

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

addRange(range)

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

पैरामीटर

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

वापसी का टिकट

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

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