Class TextRange

TextRange

Shape या TableCell के टेक्स्ट कॉन्टेंट का एक सेगमेंट.

अगर टेक्स्ट को किसी शेप में फ़िट करने के तरीके में बदलाव किया जाता है, तो शेप पर लागू की गई सभी ऑटोफ़िट सेटिंग बंद हो जाती हैं.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
appendParagraph(text)Paragraphयह टेक्स्ट रेंज के आखिर में एक पैराग्राफ़ जोड़ता है.
appendRange(textRange)TextRangeयह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को मौजूदा टेक्स्ट रेंज के आखिर में जोड़ता है.
appendRange(textRange, matchSourceFormatting)TextRangeयह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को मौजूदा टेक्स्ट रेंज के आखिर में जोड़ता है.
appendText(text)TextRangeइस फ़ंक्शन की मदद से, टेक्स्ट रेंज के आखिर में टेक्स्ट जोड़ा जा सकता है.
asRenderedString()Stringयह फ़ंक्शन, रेंडर किए गए टेक्स्ट को दिखाता है. यह टेक्स्ट, किसी शेप या टेबल सेल की इस रेंज में मौजूद होता है. यह टेक्स्ट, असली उपयोगकर्ताओं को दिखाने के लिए सही फ़ॉर्मैट में होता है.
asString()Stringयह फ़ंक्शन, लिंक किए गए शेप या टेबल सेल की इस रेंज में मौजूद रॉ टेक्स्ट दिखाता है.
clear()voidइस रेंज में मौजूद टेक्स्ट को मिटाता है.
clear(startOffset, endOffset)voidइस तरीके से, रेंज में मौजूद शुरुआती और आखिरी ऑफ़सेट के बीच के टेक्स्ट को मिटाया जाता है.
find(pattern)TextRange[]यह फ़ंक्शन, मौजूदा टेक्स्ट रेंज में खोज के पैटर्न से मेल खाने वाली सभी रेंज दिखाता है.
find(pattern, startOffset)TextRange[]यह फ़ंक्शन, मौजूदा टेक्स्ट रेंज में खोज के पैटर्न से मेल खाने वाली सभी रेंज दिखाता है. ये रेंज, स्टार्ट ऑफ़सेट से शुरू होती हैं.
getAutoTexts()AutoText[]इससे, टेक्स्ट की मौजूदा रेंज में मौजूद अपने-आप भरने वाले टेक्स्ट मिलते हैं.
getEndIndex()Integerयह फ़ंक्शन, इस रेंज में मौजूद आखिरी वर्ण के लिए, 0 से शुरू होने वाला इंडेक्स दिखाता है.
getLength()Integerइस रेंज में मौजूद वर्णों की संख्या दिखाता है.
getLinks()TextRange[]यह फ़ंक्शन, टेक्स्ट रेंज का ऐसा कलेक्शन दिखाता है जो मौजूदा टेक्स्ट रेंज में मौजूद सभी Link या मौजूदा टेक्स्ट रेंज से ओवरलैप होने वाले Link से मेल खाता है.
getListParagraphs()Paragraph[]यह फ़ंक्शन, सूचियों में मौजूद उन पैराग्राफ़ को दिखाता है जो मौजूदा टेक्स्ट रेंज से ओवरलैप होते हैं.
getListStyle()ListStyleमौजूदा टेक्स्ट रेंज का ListStyle दिखाता है.
getParagraphStyle()ParagraphStyleमौजूदा टेक्स्ट रेंज का ParagraphStyle दिखाता है.
getParagraphs()Paragraph[]यह फ़ंक्शन, उन पैराग्राफ़ को दिखाता है जो टेक्स्ट की मौजूदा रेंज से ओवरलैप होते हैं.
getRange(startOffset, endOffset)TextRangeयह फ़ंक्शन, TextRange का नया ऑब्जेक्ट दिखाता है. यह ऑब्जेक्ट, उस रेंज का हिस्सा होता है जिससे इसे बनाया गया है.
getRuns()TextRange[]यह फ़ंक्शन, टेक्स्ट की उन रेंज को दिखाता है जो मौजूदा टेक्स्ट रेंज से ओवरलैप होती हैं.
getStartIndex()Integerयह फ़ंक्शन, इस रेंज में मौजूद पहले वर्ण के लिए, 0 से शुरू होने वाला इंडेक्स दिखाता है.
getTextStyle()TextStyleयह फ़ंक्शन, रेंज की टेक्स्ट स्टाइल दिखाता है. अगर रेंज खाली है, तो null दिखाता है.
insertParagraph(startOffset, text)Paragraphयह फ़ंक्शन, ऑफ़सेट की शुरुआत में एक पैराग्राफ़ डालता है.
insertRange(startOffset, textRange)TextRangeयह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को स्टार्ट ऑफ़सेट में डालता है.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeयह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को स्टार्ट ऑफ़सेट में डालता है.
insertText(startOffset, text)TextRangeयह फ़ंक्शन, टेक्स्ट को ऑफ़सेट की शुरुआत में डालता है.
isEmpty()Booleanअगर इस रेंज में कोई वर्ण नहीं है, तो true दिखाता है. अगर इस रेंज में कोई वर्ण है, तो false दिखाता है.
replaceAllText(findText, replaceText)Integer'ढूंढने के लिए टेक्स्ट' से मेल खाने वाले टेक्स्ट के सभी इंस्टेंस को 'बदलने के लिए टेक्स्ट' से बदलता है.
replaceAllText(findText, replaceText, matchCase)Integer'ढूंढने के लिए टेक्स्ट' से मेल खाने वाले टेक्स्ट के सभी इंस्टेंस को 'बदलने के लिए टेक्स्ट' से बदलता है.
select()voidइससे सिर्फ़ चालू प्रज़ेंटेशन में मौजूद TextRange चुना जाता है. साथ ही, पहले से चुने गए किसी भी आइटम को हटा दिया जाता है.
setText(newText)TextRangeइस रेंज से जुड़े शेप या टेबल सेल में मौजूद टेक्स्ट सेट करता है.

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

appendParagraph(text)

यह टेक्स्ट रेंज के आखिर में एक पैराग्राफ़ जोड़ता है. पैराग्राफ़ में, मौजूदा टेक्स्ट रेंज के आखिर की स्टाइलिंग बनी रहती है.

दी गई टेक्स्ट स्ट्रिंग को पैराग्राफ़ के तौर पर जोड़ा जाता है. इसके लिए, स्ट्रिंग में कम से कम एक नई लाइन का वर्ण जोड़ा जाता है.

अगर दी गई टेक्स्ट स्ट्रिंग में नई लाइन वाले वर्ण शामिल हैं (इस तरह, इसमें कई पैराग्राफ़ शामिल हैं), तो जोड़े गए आखिरी पैराग्राफ़ को दिखाया जाता है.

पैरामीटर

नामटाइपब्यौरा
textStringवह स्ट्रिंग जिसे पैराग्राफ़ के तौर पर जोड़ना है.

वापसी का टिकट

Paragraph — जोड़े गए Paragraph.

अनुमति देना

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

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

appendRange(textRange)

यह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को मौजूदा टेक्स्ट रेंज के आखिर में जोड़ता है.

शामिल किए गए टेक्स्ट की फ़ॉर्मैटिंग, सोर्स टेक्स्ट की फ़ॉर्मैटिंग से मेल खाती है.

पैरामीटर

नामटाइपब्यौरा
textRangeTextRangeजोड़ने के लिए टेक्स्ट रेंज.

वापसी का टिकट

TextRange — यह टेक्स्ट रेंज, जोड़े गए टेक्स्ट को दिखाती है.

अनुमति देना

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

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

appendRange(textRange, matchSourceFormatting)

यह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को मौजूदा टेक्स्ट रेंज के आखिर में जोड़ता है.

अगर इसे डेस्टिनेशन टेक्स्ट के फ़ॉर्मैट से मेल खाने के लिए सेट किया जाता है, तो दिए गए टेक्स्ट रेंज में मौजूद AutoText को उनकी रेंडर की गई वैल्यू से बदल दिया जाता है. इसके अलावा, दी गई टेक्स्ट रेंज में मौजूद किसी भी नॉन-टेक्स्ट एलिमेंट को नहीं जोड़ा जाता.

पैरामीटर

नामटाइपब्यौरा
textRangeTextRangeजोड़ने के लिए टेक्स्ट रेंज.
matchSourceFormattingBooleanअगर true है, तो सोर्स टेक्स्ट की फ़ॉर्मैटिंग से मेल खाएं. अगर false है, तो डेस्टिनेशन टेक्स्ट की फ़ॉर्मैटिंग से मेल खाएं.

वापसी का टिकट

TextRange — यह टेक्स्ट रेंज, जोड़े गए टेक्स्ट को दिखाती है.

अनुमति देना

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

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

appendText(text)

इस फ़ंक्शन की मदद से, टेक्स्ट रेंज के आखिर में टेक्स्ट जोड़ा जा सकता है. टेक्स्ट में, मौजूदा टेक्स्ट के आखिर की स्टाइल बनी रहती है.

पैरामीटर

नामटाइपब्यौरा
textStringजोड़ी जाने वाली स्ट्रिंग.

वापसी का टिकट

TextRange — यह टेक्स्ट रेंज, जोड़े गए टेक्स्ट को दिखाती है.

अनुमति देना

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

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

asRenderedString()

यह फ़ंक्शन, रेंडर किए गए टेक्स्ट को दिखाता है. यह टेक्स्ट, किसी शेप या टेबल सेल की इस रेंज में मौजूद होता है. यह टेक्स्ट, असली उपयोगकर्ताओं को दिखाने के लिए सही फ़ॉर्मैट में होता है.

ऑटोटेक्स्ट एलिमेंट, जैसे कि जनरेट किए गए स्लाइड नंबर, उनकी रेंडर की गई वैल्यू से बदल दिए जाते हैं. रेंज में मौजूद किसी भी नॉन-टेक्स्ट एलिमेंट को शामिल नहीं किया जाता.

वापसी का टिकट

String — रेंज में रेंडर किया गया टेक्स्ट.

अनुमति देना

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

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

asString()

यह फ़ंक्शन, लिंक किए गए शेप या टेबल सेल की इस रेंज में मौजूद रॉ टेक्स्ट दिखाता है.

अपने-आप जनरेट होने वाले स्लाइड नंबर जैसे टेक्स्ट एलिमेंट और रेंज में मौजूद किसी भी नॉन-टेक्स्ट एलिमेंट को यूनिकोड वर्ण U+E907 से बदल दिया जाता है.

वापसी का टिकट

String — रेंज में मौजूद रॉ टेक्स्ट.

अनुमति देना

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

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

clear()

इस रेंज में मौजूद टेक्स्ट को मिटाता है.

Shape या TableCell में मौजूद पूरे टेक्स्ट के आखिर में नई लाइन होनी चाहिए. इसलिए, टेक्स्ट में मौजूद आखिरी नई लाइन को नहीं हटाया जाता.

अनुमति देना

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

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

clear(startOffset, endOffset)

इस तरीके से, रेंज में मौजूद शुरुआती और आखिरी ऑफ़सेट के बीच के टेक्स्ट को मिटाया जाता है.

टेक्स्ट के आखिर में नई लाइन होनी चाहिए. इसलिए, टेक्स्ट में मौजूद आखिरी नई लाइन को नहीं हटाया जाता. भले ही, वह दिए गए ऑफ़सेट में शामिल हो.

पैरामीटर

नामटाइपब्यौरा
startOffsetIntegerयह, इस्तेमाल की गई मौजूदा टेक्स्ट रेंज के शुरुआती इंडेक्स के बाद के वर्णों की संख्या है. इसका इस्तेमाल, मिटाने के लिए रेंज का शुरुआती इंडेक्स तय करने के लिए किया जाता है. शुरू होने का ऑफ़सेट, 0 के बराबर या इससे ज़्यादा और endOffset के बराबर या इससे कम होना चाहिए. startOffset की वैल्यू, मौजूदा रेंज की लंबाई से कम होनी चाहिए.
endOffsetIntegerयह मौजूदा टेक्स्ट रेंज के स्टार्ट इंडेक्स के बाद के वर्णों की संख्या है. इसका इस्तेमाल, मिटाने के लिए रेंज का एक्सक्लूसिव एंड इंडेक्स तय करने के लिए किया जाता है. endOffset की वैल्यू, startOffset के बराबर या इससे ज़्यादा होनी चाहिए. endOffset की वैल्यू, मौजूदा रेंज की लंबाई से कम या उसके बराबर होनी चाहिए.

अनुमति देना

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

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

find(pattern)

यह फ़ंक्शन, मौजूदा टेक्स्ट रेंज में खोज के पैटर्न से मेल खाने वाली सभी रेंज दिखाता है. खोज के नतीजे, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं.

पैरामीटर

नामटाइपब्यौरा
patternStringखोज के लिए रेगुलर एक्सप्रेशन पैटर्न; पैटर्न में मौजूद किसी भी बैकस्लैश को एस्केप किया जाना चाहिए.

वापसी का टिकट

TextRange[] — टेक्स्ट रेंज की सूची.

अनुमति देना

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

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

find(pattern, startOffset)

यह फ़ंक्शन, मौजूदा टेक्स्ट रेंज में खोज के पैटर्न से मेल खाने वाली सभी रेंज दिखाता है. ये रेंज, स्टार्ट ऑफ़सेट से शुरू होती हैं. खोज के लिए इस्तेमाल किए गए शब्दों में, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) का ध्यान रखने की ज़रूरत होती है.

पैरामीटर

नामटाइपब्यौरा
patternStringखोज के लिए रेगुलर एक्सप्रेशन पैटर्न; पैटर्न में मौजूद किसी भी बैकस्लैश को एस्केप किया जाना चाहिए.
startOffsetIntegerयह, मौजूदा टेक्स्ट रेंज के शुरुआती इंडेक्स के बाद के वर्णों की संख्या है. इसका इस्तेमाल, खोजे जाने वाली रेंज के शुरुआती इंडेक्स का पता लगाने के लिए किया जाता है. startOffset की वैल्यू, मौजूदा रेंज की लंबाई से कम होनी चाहिए.

वापसी का टिकट

TextRange[] — टेक्स्ट रेंज की सूची.

अनुमति देना

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

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

getAutoTexts()

इससे, टेक्स्ट की मौजूदा रेंज में मौजूद अपने-आप भरने वाले टेक्स्ट मिलते हैं.

वापसी का टिकट

AutoText[] — अपने-आप लिखे गए लेखों की सूची.

अनुमति देना

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

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

getEndIndex()

यह फ़ंक्शन, इस रेंज में मौजूद आखिरी वर्ण के लिए, 0 से शुरू होने वाला इंडेक्स दिखाता है. अगर शुरू और खत्म होने वाले इंडेक्स बराबर हैं, तो रेंज को खाली माना जाता है.

वापसी का टिकट

Integer — रेंज का आखिरी इंडेक्स.

अनुमति देना

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

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

getLength()

इस रेंज में मौजूद वर्णों की संख्या दिखाता है.

वापसी का टिकट

Integer — इस रेंज में वर्णों की संख्या.

अनुमति देना

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

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

यह फ़ंक्शन, टेक्स्ट रेंज का ऐसा कलेक्शन दिखाता है जो मौजूदा टेक्स्ट रेंज में मौजूद सभी Link या मौजूदा टेक्स्ट रेंज से ओवरलैप होने वाले Link से मेल खाता है.

जब कोई रेंज बनाई जाती है, तो यह गारंटी दी जाती है कि हर रेंज में कम से कम एक लिंक होगा. टेक्स्ट में बदलाव करने से, यह ज़रूरी नहीं कि वह सिर्फ़ एक लिंक को दिखाए.

लौटाई गई रेंज में मौजूद हर Link को TextStyle.getLink() के ज़रिए ऐक्सेस किया जा सकता है. 

// Accesses the first link on a TextRange object. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); const linkTextRange = textRange.getLinks()[0]; const textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink());   // logs 'true' const link = textStyle.getLink();  // Link object

वापसी का टिकट

TextRange[] — टेक्स्ट रेंज की सूची.

अनुमति देना

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

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

getListParagraphs()

यह फ़ंक्शन, सूचियों में मौजूद उन पैराग्राफ़ को दिखाता है जो मौजूदा टेक्स्ट रेंज से ओवरलैप होते हैं.

वापसी का टिकट

Paragraph[] — सूचियों में पैराग्राफ़ की सूची.

अनुमति देना

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

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

getListStyle()

मौजूदा टेक्स्ट रेंज का ListStyle दिखाता है.

वापसी का टिकट

ListStyle — मौजूदा टेक्स्ट रेंज की सूची की स्टाइल.

अनुमति देना

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

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

getParagraphStyle()

मौजूदा टेक्स्ट रेंज का ParagraphStyle दिखाता है.

वापसी का टिकट

ParagraphStyle — मौजूदा टेक्स्ट रेंज की पैराग्राफ़ स्टाइल.

अनुमति देना

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

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

getParagraphs()

यह फ़ंक्शन, उन पैराग्राफ़ को दिखाता है जो टेक्स्ट की मौजूदा रेंज से ओवरलैप होते हैं.

वापसी का टिकट

Paragraph[] — पैराग्राफ़ की सूची.

अनुमति देना

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

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

getRange(startOffset, endOffset)

यह फ़ंक्शन, TextRange का नया ऑब्जेक्ट दिखाता है. यह ऑब्जेक्ट, उस रेंज का हिस्सा होता है जिससे इसे बनाया गया है.

पैरामीटर

नामटाइपब्यौरा
startOffsetIntegerयह संख्या, मौजूदा टेक्स्ट रेंज के स्टार्ट इंडेक्स के बाद के वर्णों की संख्या होती है. इसका इस्तेमाल, दिखाई गई रेंज के स्टार्ट इंडेक्स का पता लगाने के लिए किया जाता है. शुरू होने का ऑफ़सेट, 0 के बराबर या इससे ज़्यादा और endOffset के बराबर या इससे कम होना चाहिए. startOffset की वैल्यू, मौजूदा रेंज की लंबाई से कम होनी चाहिए.
endOffsetIntegerयह संख्या, मौजूदा टेक्स्ट रेंज के स्टार्ट इंडेक्स के बाद के वर्णों की संख्या होती है. इसका इस्तेमाल, दिखाई गई रेंज के एक्सक्लूसिव एंड इंडेक्स का पता लगाने के लिए किया जाता है. endOffset की वैल्यू, startOffset के बराबर या इससे ज़्यादा होनी चाहिए. endOffset की वैल्यू, मौजूदा रेंज की लंबाई से कम या उसके बराबर होनी चाहिए.

वापसी का टिकट

TextRange — टेक्स्ट की नई रेंज.

अनुमति देना

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

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

getRuns()

यह फ़ंक्शन, टेक्स्ट की उन रेंज को दिखाता है जो मौजूदा टेक्स्ट रेंज से ओवरलैप होती हैं. टेक्स्ट रन, टेक्स्ट का एक ऐसा सेगमेंट होता है जिसमें सभी वर्णों की टेक्स्ट स्टाइल एक जैसी होती है.

जब किसी रेंज को बनाया जाता है, तब यह सिर्फ़ एक बार चलने की गारंटी देती है. टेक्स्ट या स्टाइल में बदलाव करने से, हो सकता है कि यह एक रन को सटीक तरीके से न दिखाए.

वापसी का टिकट

TextRange[] — टेक्स्ट रेंज की सूची.

अनुमति देना

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

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

getStartIndex()

यह फ़ंक्शन, इस रेंज में मौजूद पहले वर्ण के लिए, 0 से शुरू होने वाला इंडेक्स दिखाता है. अगर शुरू और खत्म होने वाले इंडेक्स बराबर हैं, तो रेंज को खाली माना जाता है.

वापसी का टिकट

Integer — रेंज का शुरुआती इंडेक्स.

अनुमति देना

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

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

getTextStyle()

यह फ़ंक्शन, रेंज की टेक्स्ट स्टाइल दिखाता है. अगर रेंज खाली है, तो null दिखाता है.

वापसी का टिकट

TextStyle — रेंज के टेक्स्ट की स्टाइल.

अनुमति देना

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

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

insertParagraph(startOffset, text)

यह फ़ंक्शन, ऑफ़सेट की शुरुआत में एक पैराग्राफ़ डालता है. पैराग्राफ़ में, शुरुआती ऑफ़सेट पर मौजूद मौजूदा टेक्स्ट रेंज की स्टाइल बनी रहती है.

दी गई टेक्स्ट स्ट्रिंग को पैराग्राफ़ के तौर पर डाला जाता है. इसके लिए, स्ट्रिंग में कम से कम एक नई लाइन वाला वर्ण जोड़ा जाता है.

अगर दी गई टेक्स्ट स्ट्रिंग में नई लाइन वाले वर्ण शामिल हैं (इस तरह, इसमें कई पैराग्राफ़ शामिल हैं), तो जोड़े गए आखिरी पैराग्राफ़ को दिखाया जाता है.

पैरामीटर

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

वापसी का टिकट

Paragraph — यह शामिल किया गया Paragraph है.

अनुमति देना

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

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

insertRange(startOffset, textRange)

यह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को स्टार्ट ऑफ़सेट में डालता है.

शामिल किए गए टेक्स्ट की फ़ॉर्मैटिंग, सोर्स टेक्स्ट की फ़ॉर्मैटिंग से मेल खाती है.

पैरामीटर

नामटाइपब्यौरा
startOffsetIntegerयह संख्या, मौजूदा टेक्स्ट रेंज के शुरुआती इंडेक्स के बाद के उन वर्णों की संख्या होती है जिनका इस्तेमाल, टेक्स्ट डालने के लिए शुरुआती इंडेक्स तय करने के लिए किया जाता है.
textRangeTextRangeवह टेक्स्ट रेंज जिसे शामिल करना है.

वापसी का टिकट

TextRange — यह टेक्स्ट रेंज, जोड़े गए टेक्स्ट को दिखाती है.

अनुमति देना

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

यह फ़ंक्शन, दी गई टेक्स्ट रेंज की कॉपी को स्टार्ट ऑफ़सेट में डालता है.

अगर इसे डेस्टिनेशन टेक्स्ट के फ़ॉर्मैट से मेल खाने के लिए सेट किया जाता है, तो दिए गए टेक्स्ट रेंज में मौजूद AutoText को उनकी रेंडर की गई वैल्यू से बदल दिया जाता है. इसके अलावा, टेक्स्ट की दी गई रेंज में मौजूद टेक्स्ट के अलावा किसी भी अन्य एलिमेंट को नहीं डाला जाता.

पैरामीटर

नामटाइपब्यौरा
startOffsetIntegerयह संख्या, मौजूदा टेक्स्ट रेंज के शुरुआती इंडेक्स के बाद के उन वर्णों की संख्या होती है जिनका इस्तेमाल, टेक्स्ट डालने के लिए शुरुआती इंडेक्स तय करने के लिए किया जाता है.
textRangeTextRangeवह टेक्स्ट रेंज जिसे शामिल करना है.
matchSourceFormattingBooleanअगर true है, तो सोर्स टेक्स्ट की फ़ॉर्मैटिंग से मेल खाएं. अगर false है, तो डेस्टिनेशन टेक्स्ट की फ़ॉर्मैटिंग से मेल खाएं.

वापसी का टिकट

TextRange — यह टेक्स्ट रेंज, जोड़े गए टेक्स्ट को दिखाती है.

अनुमति देना

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

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

insertText(startOffset, text)

यह फ़ंक्शन, टेक्स्ट को ऑफ़सेट की शुरुआत में डालता है. टेक्स्ट में, शुरुआती ऑफ़सेट पर मौजूद टेक्स्ट की स्टाइल बनी रहती है.

पैरामीटर

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

वापसी का टिकट

TextRange — यह टेक्स्ट रेंज, जोड़े गए टेक्स्ट को दिखाती है.

अनुमति देना

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

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

isEmpty()

अगर इस रेंज में कोई वर्ण नहीं है, तो true दिखाता है. अगर इस रेंज में कोई वर्ण है, तो false दिखाता है.

वापसी का टिकट

अगर इस रेंज में कोई वर्ण नहीं है, तो Boolean — true दिखाता है. ऐसा न होने पर, false दिखाता है .

अनुमति देना

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

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

replaceAllText(findText, replaceText)

'ढूंढने के लिए टेक्स्ट' से मेल खाने वाले टेक्स्ट के सभी इंस्टेंस को 'बदलने के लिए टेक्स्ट' से बदलता है. खोज के नतीजे, केस-इनसेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं.

पैरामीटर

नामटाइपब्यौरा
findTextStringवह टेक्स्ट जिसे ढूंढना है.
replaceTextStringमैच किए गए टेक्स्ट को बदलने के लिए इस्तेमाल किया जाने वाला टेक्स्ट.

वापसी का टिकट

Integer — इवेंट के दोहराए जाने की संख्या में बदलाव हुआ

अनुमति देना

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

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

replaceAllText(findText, replaceText, matchCase)

'ढूंढने के लिए टेक्स्ट' से मेल खाने वाले टेक्स्ट के सभी इंस्टेंस को 'बदलने के लिए टेक्स्ट' से बदलता है.

पैरामीटर

नामटाइपब्यौरा
findTextStringवह टेक्स्ट जिसे ढूंढना है.
replaceTextStringमैच किए गए टेक्स्ट को बदलने के लिए इस्तेमाल किया जाने वाला टेक्स्ट.
matchCaseBooleanअगर true है, तो खोज केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होगी. अगर false है, तो खोज केस-इनसेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होगी.

वापसी का टिकट

Integer — इवेंट के दोहराए जाने की संख्या में बदलाव हुआ

अनुमति देना

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

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

select()

इससे सिर्फ़ चालू प्रज़ेंटेशन में मौजूद TextRange चुना जाता है. साथ ही, पहले से चुने गए किसी भी आइटम को हटा दिया जाता है.

कोई स्क्रिप्ट सिर्फ़ उस उपयोगकर्ता के चुने गए डेटा को ऐक्सेस कर सकती है जो स्क्रिप्ट चला रहा है. ऐसा सिर्फ़ तब हो सकता है, जब स्क्रिप्ट प्रज़ेंटेशन से बाइंड हो.

Shape या TableCell के पैरंट Page को current page selection के तौर पर सेट किया जाता है. Shape या TableCell को selected page element के तौर पर सेट किया गया हो.

    Selection दो तरह के हो सकते हैं:
    • 1. टेक्स्ट की रेंज. वर्णों की रेंज चुनने के लिए, खाली नहीं है ऐसे TextRange पर select का इस्तेमाल करें.
    • 2. कर्सर की पोज़िशन. कर्सर को अपनी पसंद के इंडेक्स पर रखने के लिए, खाली TextRange का इस्तेमाल करें. 
      const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText('Hello'); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();

      अनुमति देना

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

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

    setText(newText)

    इस रेंज से जुड़े शेप या टेबल सेल में मौजूद टेक्स्ट सेट करता है. टेक्स्ट में, मौजूदा टेक्स्ट की शुरुआत वाली स्टाइल बनी रहती है.

    पैरामीटर

    नामटाइपब्यौरा
    newTextStringयह स्ट्रिंग, नए टेक्स्ट के तौर पर सेट की जाती है.

    वापसी का टिकट

    TextRange — यह टेक्स्ट रेंज, सेट किए गए टेक्स्ट को दिखाती है.

    अनुमति देना

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

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