Class TextRange

محدوده متن

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

اگر از روش‌هایی استفاده کنید که نحوه‌ی قرارگیری متن در یک شکل را ویرایش می‌کنند، هرگونه تنظیمات 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 متن محدود شده توسط این محدوده از شکل یا سلول جدول مرتبط را تنظیم می‌کند.

مستندات دقیق

appendParagraph(text)

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

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

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

پارامترها

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

بازگشت

Paragraph — Paragraph الحاقی.

مجوز

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

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

appendRange(textRange)

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

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

پارامترها

نام نوع توضیحات
text Range Text Range محدوده متنی که قرار است اضافه شود.

بازگشت

TextRange - محدوده متنی که متن پیوست شده را نشان می‌دهد.

مجوز

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

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

appendRange(textRange, matchSourceFormatting)

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

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

پارامترها

نام نوع توضیحات
text Range Text Range محدوده متنی که قرار است اضافه شود.
match Source Formatting 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 مانند شماره اسلایدهای تولید شده و هر عنصر غیر متنی در محدوده با کاراکتر یونیکد 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 شود.

بازگشت

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

مجوز

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

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

find(pattern, startOffset)

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

پارامترها

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

بازگشت

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

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

بازگشت

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.
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 جدید برمی‌گرداند که بخشی از محدوده‌ای را که از آن مشتق شده است، پوشش می‌دهد.

پارامترها

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

بازگشت

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

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

بازگشت

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

مجوز

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

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

getTextStyle()

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

بازگشت

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

مجوز

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

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

insertParagraph(startOffset, text)

یک پاراگراف را در نقطه شروع درج می‌کند. پاراگراف، استایل محدوده متن فعلی را در نقطه شروع حفظ می‌کند.

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

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

پارامترها

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

بازگشت

Paragraph — Paragraph درج شده.

مجوز

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

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

insertRange(startOffset, textRange)

یک کپی از محدوده متن ارائه شده را در نقطه شروع درج می‌کند.

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

یک کپی از محدوده متن ارائه شده را در نقطه شروع درج می‌کند.

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertText(startOffset, text)

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

پارامترها

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

بازگشت

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)

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

پارامترها

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

بازگشت

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

مجوز

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

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

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

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

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

Page والد Shape یا TableCell مربوطه به عنوان current page selection تنظیم می‌شود. Shape یا TableCell به عنوان 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

    setText(newText)

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

    پارامترها

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

    بازگشت

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

    مجوز

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

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