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 से मिलती-जुलती हों या मौजूदा टेक्स्ट रेंज को ओवरलैप करती हों.
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)

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

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

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

पैरामीटर

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

रिटर्न

Paragraph — जोड़े गए Paragraph.

अनुमति देना

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

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

appendRange(textRange)

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

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

पैरामीटर

नामTypeब्यौरा
textRangeTextRangeजोड़ी जाने वाली टेक्स्ट रेंज.

रिटर्न

TextRange — जोड़े गए टेक्स्ट को दिखाने वाली टेक्स्ट रेंज

अनुमति देना

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

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

appendRange(textRange, matchSourceFormatting)

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

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

पैरामीटर

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

रिटर्न

TextRange — जोड़े गए टेक्स्ट को दिखाने वाली टेक्स्ट रेंज

अनुमति देना

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

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

appendText(text)

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

पैरामीटर

नामTypeब्यौरा
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()

इस रेंज से जुड़े टेक्स्ट को मिटाता है.

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

अनुमति देना

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

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

clear(startOffset, endOffset)

रेंज में स्टार्ट और एंड ऑफ़सेट से जुड़े टेक्स्ट को हटाता है.

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

पैरामीटर

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

अनुमति देना

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

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

find(pattern)

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

पैरामीटर

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

रिटर्न

TextRange[]

अनुमति देना

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

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

find(pattern, startOffset)

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

पैरामीटर

नामTypeब्यौरा
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 को TextStyle.getLink() के ज़रिए ऐक्सेस किया जा सकता है.

// Accesses the first link on a TextRange object.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var 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 देता है जिससे यह मिला था.

पैरामीटर

नामTypeब्यौरा
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)

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

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

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

पैरामीटर

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

रिटर्न

Paragraph — डाला गया Paragraph.

अनुमति देना

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

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

insertRange(startOffset, textRange)

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

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

पैरामीटर

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

रिटर्न

TextRange — शामिल किए गए टेक्स्ट को दिखाने वाली टेक्स्ट रेंज

अनुमति देना

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

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

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

पैरामीटर

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

रिटर्न

TextRange — शामिल किए गए टेक्स्ट को दिखाने वाली टेक्स्ट रेंज

अनुमति देना

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

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

insertText(startOffset, text)

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

पैरामीटर

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

रिटर्न

TextRange — शामिल किए गए टेक्स्ट को दिखाने वाली टेक्स्ट रेंज.

अनुमति देना

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

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

isEmpty()

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

रिटर्न

Boolean

अनुमति देना

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

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

replaceAllText(findText, replaceText)

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

पैरामीटर

नामTypeब्यौरा
findTextStringढूंढने के लिए टेक्स्ट.
replaceTextStringमेल खाने वाले टेक्स्ट को बदलने के लिए टेक्स्ट.

रिटर्न

Integer — गड़बड़ियों की संख्या में बदलाव हुआ

अनुमति देना

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

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

replaceAllText(findText, replaceText, matchCase)

टेक्स्ट ढूंढने वाले टेक्स्ट के सभी इंस्टेंस को, टेक्स्ट बदलें वाले टेक्स्ट से बदलता है.

पैरामीटर

नामTypeब्यौरा
findTextStringढूंढने के लिए टेक्स्ट.
replaceTextStringमेल खाने वाले टेक्स्ट को बदलने के लिए टेक्स्ट.
matchCaseBooleantrue होने पर, खोज को केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) किया जाता है. अगर 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 पर 'चुनें' रेंज का इस्तेमाल करें जो खाली न हो.
    • 2. कर्सर की स्थिति, कर्सर को मनचाहे इंडेक्स पर रखने के लिए किसी खाली TextRange का इस्तेमाल करें.
      var 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)

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

    पैरामीटर

    नामTypeब्यौरा
    newTextStringनए टेक्स्ट के तौर पर सेट की जाने वाली स्ट्रिंग.

    रिटर्न

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

    अनुमति देना

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

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