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)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

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