Class TextRange

محدوده متن

بخشی از محتوای متن یک Table Cell Shape یا جدول.

اگر از روش‌هایی استفاده می‌کنید که نحوه تناسب متن را در یک شکل ویرایش می‌کنند، هر گونه تنظیمات تنظیم خودکار اعمال شده روی شکل غیرفعال می‌شود.

روش ها

روش نوع برگشت شرح مختصر
append Paragraph(text) Paragraph یک پاراگراف را در انتهای محدوده متن اضافه می کند.
append Range(textRange) Text Range یک کپی از محدوده متن ارائه شده را به انتهای محدوده متن فعلی اضافه می کند.
append Range(textRange, matchSourceFormatting) Text Range یک کپی از محدوده متن ارائه شده را به انتهای محدوده متن فعلی اضافه می کند.
append Text(text) Text Range متن را در انتهای محدوده متن اضافه می کند.
as Rendered String() String متن ارائه شده محدود شده توسط این محدوده از شکل یا سلول جدول مربوطه را در قالبی مناسب برای نمایش به کاربران نهایی برمی‌گرداند.
as String() String متن خام محدود شده با این محدوده از شکل یا سلول جدول مربوطه را برمی‌گرداند.
clear() void متن محدود شده توسط این محدوده را پاک می کند.
clear(startOffset, endOffset) void متن محدود شده با آفست شروع و پایان در محدوده را پاک می کند.
find(pattern) Text Range[] تمام محدوده های مطابق با الگوی جستجو را در محدوده متن فعلی برمی گرداند.
find(pattern, startOffset) Text Range[] همه محدوده های منطبق با الگوی جستجو را در محدوده متن فعلی که از شروع آفست شروع می شود، برمی گرداند.
get Auto Texts() Auto Text[] متون خودکار را در محدوده متن فعلی برمی گرداند.
get End Index() Integer شاخص انحصاری و مبتنی بر 0 را برای آخرین نویسه در این محدوده برمی‌گرداند.
get Length() Integer تعداد کاراکترهای این محدوده را برمی‌گرداند.
get Links() Text Range[] مجموعه‌ای از محدوده‌های متنی را برمی‌گرداند که مربوط به همه Link موجود در محدوده متن فعلی یا همپوشانی با محدوده متن فعلی است.
get List Paragraphs() Paragraph[] پاراگراف هایی را در لیست هایی که با محدوده متن فعلی همپوشانی دارند برمی گرداند.
get List Style() List Style List Style محدوده متن فعلی را برمی‌گرداند.
get Paragraph Style() Paragraph Style Paragraph Style محدوده متن فعلی را برمی‌گرداند.
get Paragraphs() Paragraph[] پاراگراف هایی را برمی گرداند که با محدوده متن فعلی همپوشانی دارند.
get Range(startOffset, endOffset) Text Range Text Range جدیدی را که بخشی از محدوده ای را که از آن مشتق شده است را پوشش می دهد.
get Runs() Text Range[] اجراهای متنی را برمی‌گرداند که با محدوده متن فعلی همپوشانی دارند.
get Start Index() Integer شاخص شامل و مبتنی بر 0 را برای اولین نویسه در این محدوده برمی‌گرداند.
get Text Style() Text Style سبک متن محدوده را برمی‌گرداند، یا اگر محدوده خالی باشد، null است.
insert Paragraph(startOffset, text) Paragraph یک پاراگراف را در شروع آفست درج می کند.
insert Range(startOffset, textRange) Text Range یک کپی از محدوده متن ارائه شده را در شروع آفست درج می کند.
insert Range(startOffset, textRange, matchSourceFormatting) Text Range یک کپی از محدوده متن ارائه شده را در شروع آفست درج می کند.
insert Text(startOffset, text) Text Range متن را در شروع آفست درج می کند.
is Empty() Boolean اگر هیچ کاراکتری در این محدوده وجود نداشته باشد true برمی‌گرداند و در غیر این صورت false برمی‌گرداند.
replace All Text(findText, replaceText) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
select() void فقط Text Range در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند.
set Text(newText) Text Range متن محدود شده با این محدوده از شکل یا سلول جدول مربوطه را تنظیم می کند.

مستندات دقیق

append Paragraph(text)

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

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

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

پارامترها

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

بازگشت

Paragraph - Paragraph الحاقی.

مجوز

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

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

append Range(textRange)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

append Range(textRange, matchSourceFormatting)

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

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

پارامترها

نام تایپ کنید توضیحات
text Range Text Range محدوده متنی که باید اضافه شود.
match Source Formatting Boolean اگر true ، با قالب بندی متن منبع مطابقت دهید. اگر false ، با قالب بندی متن مقصد مطابقت دهید.

بازگشت

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

مجوز

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

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

append Text(text)

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

پارامترها

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

بازگشت

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

مجوز

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

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

as Rendered String()

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

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

بازگشت

String

مجوز

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

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

as String()

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

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

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

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

پارامترها

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

مجوز

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

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

find(pattern)

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

پارامترها

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

بازگشت

Text Range[]

مجوز

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

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

find(pattern, startOffset)

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

پارامترها

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

بازگشت

Text Range[]

مجوز

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

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

get Auto Texts()

متون خودکار را در محدوده متن فعلی برمی گرداند.

بازگشت

Auto Text[]

مجوز

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

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

get End Index()

شاخص انحصاری و مبتنی بر 0 را برای آخرین نویسه در این محدوده برمی‌گرداند. اگر شاخص های شروع و پایان برابر باشند، محدوده خالی در نظر گرفته می شود.

بازگشت

Integer

مجوز

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

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

get Length()

تعداد کاراکترهای این محدوده را برمی‌گرداند.

بازگشت

Integer

مجوز

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

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

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

هر محدوده بازگشتی تضمین می شود که در هنگام ایجاد یک پیوند را پوشش دهد. تغییرات متن می تواند باعث شود که دیگر دقیقاً یک پیوند را نشان ندهد.

هر Link در محدوده های برگشتی را می توان از طریق Text Style.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

بازگشت

Text Range[]

مجوز

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

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

get List Paragraphs()

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

بازگشت

Paragraph[]

مجوز

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

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

get List Style()

List Style محدوده متن فعلی را برمی‌گرداند.

بازگشت

List Style

مجوز

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

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

get Paragraph Style()

Paragraph Style محدوده متن فعلی را برمی‌گرداند.

بازگشت

Paragraph Style

مجوز

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

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

get Paragraphs()

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

بازگشت

Paragraph[]

مجوز

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

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

get Range(startOffset, endOffset)

Text Range جدیدی را که بخشی از محدوده ای را که از آن مشتق شده است را پوشش می دهد.

پارامترها

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

بازگشت

Text Range

مجوز

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

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

get Runs()

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

هر محدوده بازگشتی تنها تضمین می شود که در هنگام ایجاد یک اجرا انجام شود. تغییر متن یا سبک می تواند باعث شود که دیگر دقیقاً یک اجرا را نشان ندهد.

بازگشت

Text Range[]

مجوز

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

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

get Start Index()

شاخص شامل و مبتنی بر 0 را برای اولین نویسه در این محدوده برمی‌گرداند. اگر شاخص های شروع و پایان برابر باشند، محدوده خالی در نظر گرفته می شود.

بازگشت

Integer

مجوز

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

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

get Text Style()

سبک متن محدوده را برمی‌گرداند، یا اگر محدوده خالی باشد، null است.

بازگشت

Text Style

مجوز

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

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

insert Paragraph(startOffset, text)

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

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

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

پارامترها

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

بازگشت

Paragraph - Paragraph درج شده.

مجوز

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

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

insert Range(startOffset, textRange)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insert Range(startOffset, textRange, matchSourceFormatting)

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

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

پارامترها

نام تایپ کنید توضیحات
start Offset Integer تعداد کاراکترهای گذشته از نمایه شروع محدوده متن فعلی که برای تعیین شاخص شروع فراگیر متن مورد درج استفاده می شود.
text Range Text Range محدوده متن برای درج.
match Source Formatting Boolean اگر true ، با قالب بندی متن منبع مطابقت دهید. اگر false ، با قالب بندی متن مقصد مطابقت دهید.

بازگشت

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

مجوز

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

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

insert Text(startOffset, text)

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

پارامترها

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

بازگشت

Text Range - محدوده متنی که متن درج شده را نشان می دهد.

مجوز

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

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

is Empty()

اگر هیچ کاراکتری در این محدوده وجود نداشته باشد true برمی‌گرداند و در غیر این صورت false برمی‌گرداند.

بازگشت

Boolean

مجوز

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

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

replace All Text(findText, replaceText)

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

پارامترها

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

بازگشت

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

مجوز

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

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

replace All Text(findText, replaceText, matchCase)

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

پارامترها

نام تایپ کنید توضیحات
find Text String متن برای پیدا کردن.
replace Text String متنی که جایگزین متن منطبق می شود.
match Case Boolean اگر true ، جستجو به حروف کوچک و بزرگ حساس است. اگر false ، جستجو به حروف بزرگ و کوچک حساس نیست.

بازگشت

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

مجوز

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

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

select()

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

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

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

    Selection می تواند دو نوع باشد:
    • 1. محدوده متن، از select در TextRange غیر خالی برای انتخاب محدوده کاراکترها استفاده کنید.
    • 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

    set Text(newText)

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

    پارامترها

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

    بازگشت

    Text Range - محدوده متنی که متن تنظیم شده را نشان می دهد

    مجوز

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

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