Class TextRange

محدوده متن

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

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

روش‌ها

روش نوع بازگشتی شرح مختصر
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 ایندکس فراگیر و مبتنی بر ۰ را برای اولین کاراکتر در این محدوده برمی‌گرداند.
get Text Style() Text Style |null سبک متن محدوده را برمی‌گرداند، یا اگر محدوده خالی باشد، 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 تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
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 تعداد کاراکترهای بعد از اندیس شروع محدوده متن فعلی که برای تعیین اندیس شروع فراگیر محدوده‌ای که باید پاک شود، استفاده می‌شود. آفست شروع باید مساوی یا بزرگتر از ۰ و کوچکتر یا مساوی با 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 الگوی عبارت منظم برای جستجو؛ هرگونه بک‌اسلش در الگو باید escape شود.

بازگشت

Text Range[] — فهرستی از محدوده‌های متن.

مجوز

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

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

find(pattern, startOffset)

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

پارامترها

نام نوع توضیحات
pattern String الگوی عبارت منظم برای جستجو؛ هرگونه بک‌اسلش در الگو باید escape شود.
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()

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

بازگشت

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

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

بازگشت

Integer - اندیس شروع محدوده.

مجوز

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

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

get Text Style()

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

بازگشت

Text Style |null — سبک متن محدوده.

مجوز

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

  • 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 - اگر هیچ کاراکتری در این محدوده وجود نداشته باشد، true و در غیر این صورت false را برمی‌گرداند.

مجوز

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

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

replace All Text(findText, replaceText)

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

پارامترها

نام نوع توضیحات
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 را با replace text جایگزین می‌کند.

پارامترها

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