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)

یک پاراگراف را در انتهای محدوده متن اضافه می کند. پاراگراف استایل انتهای محدوده متن فعلی را حفظ می کند.

رشته متن ارائه شده به عنوان یک پاراگراف با افزودن حداقل یک کاراکتر خط جدید اطراف به رشته اضافه می شود.

هنگامی که رشته متن ارائه شده حاوی کاراکترهای خط جدید باشد (بنابراین از چندین پاراگراف تشکیل شده است)، پاراگراف نهایی اضافه شده برگردانده می شود.

پارامترها

نام تایپ کنید توضیحات
text String رشته ای که باید به عنوان پاراگراف اضافه شود.

بازگشت

Paragraph - Paragraph الحاقی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

appendRange(textRange)

یک کپی از محدوده متن ارائه شده را به انتهای محدوده متن فعلی اضافه می کند.

قالب بندی متن درج شده با متن منبع مطابقت دارد.

پارامترها

نام تایپ کنید توضیحات
textRange TextRange محدوده متنی که باید اضافه شود.

بازگشت

TextRange - محدوده متنی که متن ضمیمه شده را نشان می دهد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

appendRange(textRange, matchSourceFormatting)

یک کپی از محدوده متن ارائه شده را به انتهای محدوده متن فعلی اضافه می کند.

اگر تنظیم شود که با قالب بندی متن مقصد مطابقت داشته باشد، AutoText در محدوده متن ارائه شده با مقادیر ارائه شده جایگزین می شود. علاوه بر این، هیچ عنصر غیر متنی در محدوده متن ارائه شده اضافه نمی شود.

پارامترها

نام تایپ کنید توضیحات
textRange TextRange محدوده متنی که باید اضافه شود.
matchSourceFormatting Boolean اگر true ، با قالب بندی متن منبع مطابقت دهید. اگر false است، با قالب بندی متن مقصد مطابقت دهید.

بازگشت

TextRange - محدوده متنی که متن ضمیمه شده را نشان می دهد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

appendText(text)

متن را در انتهای محدوده متن اضافه می کند. متن سبک پایان متن موجود را حفظ می کند.

پارامترها

نام تایپ کنید توضیحات
text String رشته ای که باید اضافه شود.

بازگشت

TextRange - محدوده متنی که متن ضمیمه شده را نشان می دهد.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

asRenderedString()

متن ارائه شده محدود شده توسط این محدوده از شکل یا سلول جدول مربوطه را در قالبی مناسب برای نمایش به کاربران نهایی برمی‌گرداند.

عناصر AutoText، مانند اعداد اسلاید تولید شده، با مقادیر رندر شده خود جایگزین می شوند. هر عنصر غیر متنی در محدوده حذف می شود.

بازگشت

String

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

asString()

متن خام محدود شده با این محدوده از شکل یا سلول جدول مربوطه را برمی‌گرداند.

عناصر AutoText مانند اعداد اسلاید تولید شده و هر عنصر غیر متنی در محدوده با کاراکتر Unicode 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)

متن محدود شده با آفست شروع و پایان در محدوده را پاک می کند.

از آنجایی که متن باید به یک خط جدید ختم شود، خط جدید نهایی در متن حذف نمی شود، حتی اگر با آفست های داده شده پوشش داده شود.

پارامترها

نام تایپ کنید توضیحات
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر محدوده برای پاک کردن استفاده می شود. آفست شروع باید مساوی یا بزرگتر از 0 و کمتر یا مساوی endOffset باشد. startOffset نیز باید کمتر از طول محدوده فعلی باشد.
endOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین نمایه پایان انحصاری محدوده برای پاک کردن استفاده می شود. endOffset باید مساوی یا بزرگتر از startOffset باشد. endOffset نیز باید کمتر یا مساوی طول محدوده فعلی باشد.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

find(pattern)

تمام محدوده های مطابق با الگوی جستجو را در محدوده متن فعلی برمی گرداند. جستجو به حروف کوچک و بزرگ حساس است.

پارامترها

نام تایپ کنید توضیحات
pattern String الگوی عبارت منظم برای جستجو. از هر گونه بک اسلش در الگو باید فرار کرد.

بازگشت

TextRange[]

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

find(pattern, startOffset)

همه محدوده های منطبق با الگوی جستجو را در محدوده متن فعلی که از شروع آفست شروع می شود، برمی گرداند. جستجو به حروف کوچک و بزرگ حساس است.

پارامترها

نام تایپ کنید توضیحات
pattern String الگوی عبارت منظم برای جستجو. از هر گونه بک اسلش در الگو باید فرار کرد.
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر محدوده مورد جستجو استفاده می شود. 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 جدید را که بخشی از محدوده ای را که از آن مشتق شده است را پوشش می دهد.

پارامترها

نام تایپ کنید توضیحات
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر محدوده برگشتی استفاده می شود. آفست شروع باید مساوی یا بزرگتر از 0 و کمتر یا مساوی endOffset باشد. startOffset نیز باید کمتر از طول محدوده فعلی باشد.
endOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین نمایه پایان انحصاری محدوده برگشتی استفاده می شود. 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)

یک پاراگراف را در شروع آفست درج می کند. این پاراگراف سبک محدوده متن فعلی را در شروع آفست حفظ می کند.

رشته متن ارائه شده به عنوان یک پاراگراف با افزودن حداقل یک کاراکتر خط جدید اطراف به رشته درج می شود.

هنگامی که رشته متن ارائه شده حاوی کاراکترهای خط جدید باشد (بنابراین از چندین پاراگراف تشکیل شده است)، پاراگراف نهایی اضافه شده برگردانده می شود.

پارامترها

نام تایپ کنید توضیحات
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر متن مورد درج استفاده می شود.
text String رشته برای درج.

بازگشت

Paragraph - Paragraph درج شده.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

insertRange(startOffset, textRange)

یک کپی از محدوده متن ارائه شده را در شروع آفست درج می کند.

قالب بندی متن درج شده با متن منبع مطابقت دارد.

پارامترها

نام تایپ کنید توضیحات
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر متن مورد درج استفاده می شود.
textRange TextRange محدوده متن برای درج.

بازگشت

TextRange - محدوده متنی که متن درج شده را نشان می دهد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

insertRange(startOffset, textRange, matchSourceFormatting)

یک کپی از محدوده متن ارائه شده را در شروع آفست درج می کند.

اگر تنظیم شود که با قالب بندی متن مقصد مطابقت داشته باشد، AutoText در محدوده متن ارائه شده با مقادیر ارائه شده جایگزین می شود. علاوه بر این، هیچ عنصر غیر متنی در محدوده متن ارائه شده درج نمی شود.

پارامترها

نام تایپ کنید توضیحات
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر متن مورد درج استفاده می شود.
textRange TextRange محدوده متن برای درج.
matchSourceFormatting Boolean اگر true ، با قالب بندی متن منبع مطابقت دهید. اگر false است، با قالب بندی متن مقصد مطابقت دهید.

بازگشت

TextRange - محدوده متنی که متن درج شده را نشان می دهد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

insertText(startOffset, text)

متن را در شروع آفست درج می کند. متن سبک متن موجود را در شروع آفست حفظ می کند.

پارامترها

نام تایپ کنید توضیحات
startOffset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر متن مورد درج استفاده می شود.
text String رشته برای درج.

بازگشت

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)

همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند. جستجو به حروف بزرگ و کوچک حساس است.

پارامترها

نام تایپ کنید توضیحات
findText String متن برای پیدا کردن.
replaceText String متنی که جایگزین متن منطبق می شود.

بازگشت

Integer - تعداد رخدادها تغییر کرد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

replaceAllText(findText, replaceText, matchCase)

همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.

پارامترها

نام تایپ کنید توضیحات
findText String متن برای پیدا کردن.
replaceText String متنی که جایگزین متن منطبق می شود.
matchCase Boolean اگر true ، جستجو به حروف کوچک و بزرگ حساس است. اگر false باشد، جستجو به حروف بزرگ و کوچک حساس نیست.

بازگشت

Integer - تعداد رخدادها تغییر کرد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

select()

فقط TextRange در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند.

یک اسکریپت فقط می‌تواند به انتخاب کاربری که اسکریپت را اجرا می‌کند، دسترسی داشته باشد، و تنها در صورتی که اسکریپت به ارائه محدود شده باشد.

Page والد Shape مربوطه یا TableCell به عنوان current page selection تنظیم شده است. Shape یا TableCell به عنوان selected page element تنظیم می شود.

    Selection می تواند دو نوع باشد:
    • 1. محدوده متن، از select در 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)

    متن محدود شده با این محدوده از شکل یا سلول جدول مربوطه را تنظیم می کند. متن سبک شروع متن موجود را حفظ می کند.

    پارامترها

    نام تایپ کنید توضیحات
    newText String رشته ای که باید به عنوان متن جدید تنظیم شود.

    بازگشت

    TextRange - محدوده متنی که متن مجموعه را نشان می دهد

    مجوز

    اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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