Class RangeBuilder

RangeBuilder

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

// Change the user's selection to a range that includes every table in the active tab.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.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)RangeBuilderRangeBuilder में, दो पार्शियल 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

ऐसे तरीके जो अब काम नहीं करते