Class TextStyle

سبک متن

سبک متن.

متدهای خواندن در این کلاس در صورتی که TextRange مربوطه شامل چندین اجرای متن باشد و آن اجراها مقادیر متفاوتی برای متد خواندن فراخوانی شده داشته باشند، null را برمی‌گردانند. برای جلوگیری از این امر، با استفاده از TextRange های برگردانده شده توسط متد TextRange.getRuns() به دنبال سبک‌های متن بگردید.

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

روش‌ها

روش نوع بازگشتی شرح مختصر
get Background Color() Color |null رنگ پس‌زمینه متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد، null برمی‌گرداند.
get Baseline Offset() Text Baseline Offset |null میزان انحراف عمودی متن از موقعیت عادی آن را برمی‌گرداند، یا اگر چندین سبک روی متن وجود داشته باشد null برمی‌گرداند.
get Font Family() String|null خانواده فونت متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد null برمی‌گرداند.
get Font Size() Number|null اندازه فونت متن را بر حسب نقطه برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد null برمی‌گرداند.
get Font Weight() Integer|null وزن فونت متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد null برمی‌گرداند.
get Foreground Color() Color |null رنگ پیش‌زمینه متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد، null برمی‌گرداند.
get Link() Link |null Link روی متن را برمی‌گرداند، یا اگر لینکی وجود نداشته باشد یا لینک روی بخشی از متن باشد یا چندین لینک وجود داشته باشد، null برمی‌گرداند.
has Link() Boolean|null اگر لینکی در متن وجود داشته باشد true در غیر این صورت false را برمی‌گرداند، و اگر لینک در بخشی از متن باشد یا چندین لینک وجود داشته باشد null را برمی‌گرداند.
is Background Transparent() Boolean|null اگر پس‌زمینه متن شفاف باشد، true ، در غیر این صورت false و در صورت وجود چندین استایل روی متن، null را برمی‌گرداند.
is Bold() Boolean|null اگر متن به صورت پررنگ (bold) نمایش داده شود، true ، در غیر این صورت false و در صورت وجود چندین سبک (style) در متن، null را برمی‌گرداند.
is Italic() Boolean|null اگر متن ایتالیک باشد true ، در غیر این صورت false و در صورت وجود چندین استایل برای متن، null را برمی‌گرداند.
is Small Caps() Boolean|null اگر متن با حروف بزرگ کوچک نوشته شده باشد، true ، در غیر این صورت false و در صورت وجود چندین سبک (style) در متن، null را برمی‌گرداند.
is Strikethrough() Boolean|null اگر متن خط خورده باشد true ، در غیر این صورت false و در صورت وجود چندین استایل برای متن، null را برمی‌گرداند.
is Underline() Boolean|null اگر متن زیرخط‌دار باشد true ، در غیر این صورت false و در صورت وجود چندین استایل برای متن، null را برمی‌گرداند.
remove Link() Text Style یک Link حذف می‌کند.
set Background Color(color) Text Style رنگ پس زمینه متن را تنظیم می‌کند.
set Background Color(red, green, blue) Text Style رنگ پس‌زمینه متن را با مقادیر RGB داده شده از ۰ تا ۲۵۵ تنظیم می‌کند.
set Background Color(hexColor) Text Style رنگ پس‌زمینه متن را با رشته رنگ هگز داده شده تنظیم می‌کند.
set Background Color(color) Text Style رنگ پس‌زمینه متن را با نوع رنگ تم Theme Color Type تعیین می‌کند.
set Background Color Transparent() Text Style رنگ پس‌زمینه متن را شفاف تنظیم می‌کند.
set Baseline Offset(offset) Text Style میزان انحراف عمودی متن نسبت به موقعیت عادی آن را تنظیم می‌کند.
set Bold(bold) Text Style تعیین می‌کند که آیا متن باید به صورت پررنگ (bold) نمایش داده شود یا خیر.
set Font Family(fontFamily) Text Style خانواده فونت متن را تنظیم می‌کند.
set Font Family And Weight(fontFamily, fontWeight) Text Style خانواده فونت و ضخامت متن را تنظیم می‌کند.
set Font Size(fontSize) Text Style اندازه فونت متن را بر حسب نقطه تنظیم می‌کند.
set Foreground Color(foregroundColor) Text Style رنگ پیش‌زمینه متن را تنظیم می‌کند.
set Foreground Color(red, green, blue) Text Style رنگ پیش‌زمینه متن را با مقادیر RGB داده شده از ۰ تا ۲۵۵ تنظیم می‌کند.
set Foreground Color(hexColor) Text Style رنگ پیش‌زمینه متن را با رشته رنگ هگز داده شده تنظیم می‌کند.
set Foreground Color(color) Text Style رنگ پیش‌زمینه متن را با نوع رنگ تم Theme Color Type تعیین می‌کند.
set Italic(italic) Text Style تنظیم می‌کند که آیا متن به صورت مورب (italic) نمایش داده شود یا خیر.
set Link Slide(slideIndex) Text Style با استفاده از اندیس مبتنی بر صفر اسلاید، Link به Slide داده شده تنظیم می‌کند.
set Link Slide(slide) Text Style یک Link به Slide داده شده تنظیم می‌کند، لینک توسط شناسه اسلاید داده شده تنظیم می‌شود.
set Link Slide(slidePosition) Text Style با استفاده از موقعیت نسبی اسلاید، Link به Slide داده شده تنظیم می‌کند.
set Link Url(url) Text Style یک Link به رشته URL غیر خالی داده شده تنظیم می‌کند.
set Small Caps(smallCaps) Text Style تنظیم می‌کند که آیا متن با حروف بزرگ کوچک نمایش داده شود یا خیر.
set Strikethrough(strikethrough) Text Style تعیین می‌کند که آیا متن خط خورده باشد یا خیر.
set Underline(underline) Text Style تنظیم می‌کند که آیا متن زیرخط‌دار باشد یا خیر.

مستندات دقیق

getBackgroundColor()

رنگ پس‌زمینه متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد، null برمی‌گرداند.

بازگشت

Color |null — رنگ پس‌زمینه متن.

مجوز

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

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

getBaselineOffset()

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

بازگشت

جابجایی متن از موقعیت عادی به TextBaselineOffset |null

مجوز

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

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

getFontFamily()

خانواده فونت متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد null برمی‌گرداند.

بازگشت

String|null — خانواده فونت متن.

مجوز

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

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

getFontSize()

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

بازگشت

Number|null — اندازه فونت متن بر حسب پوینت.

مجوز

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

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

getFontWeight()

وزن فونت متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد null برمی‌گرداند.

وزن، مضربی از ۱۰۰ است که شامل ۱۰۰ تا ۹۰۰ می‌شود. این محدوده با مقادیر عددی شرح داده شده در مشخصات CSS 2.1، بخش ۱۵.۶ ، مطابقت دارد و مقادیر غیر عددی مجاز نیستند. وزن‌های بزرگتر یا مساوی ۷۰۰، پررنگ در نظر گرفته می‌شوند، که در این صورت isBold() true را برمی‌گرداند. مقدار پیش‌فرض ۴۰۰ ("عادی") است.

بازگشت

Integer|null — وزن فونت متن.

مجوز

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

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

getForegroundColor()

رنگ پیش‌زمینه متن را برمی‌گرداند، یا اگر چندین سبک برای متن وجود داشته باشد null برمی‌گرداند.

بازگشت

Color |null — رنگ پیش‌زمینه متن.

مجوز

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

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

Link روی متن را برمی‌گرداند، یا اگر لینکی وجود نداشته باشد یا اگر لینک روی بخشی از متن باشد یا اگر چندین لینک وجود داشته باشد، null برمی‌گرداند. برای تعیین اینکه آیا متن لینکی ندارد یا خیر، تابع hasLink() را فراخوانی کنید.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`);
}

بازگشت

Link |null — لینک روی متن.

مجوز

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

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

اگر لینکی در متن وجود داشته باشد true در غیر این صورت false را برمی‌گرداند، و اگر لینک در بخشی از متن باشد یا چندین لینک وجود داشته باشد null را برمی‌گرداند.

لینک‌ها را نمی‌توان روی کاراکترهای خط جدید تنظیم کرد. بنابراین، اگر TextRange حاوی یک کاراکتر خط جدید باشد، این متد همیشه null یا false را برمی‌گرداند.

بازگشت

Boolean|null — آیا لینکی در متن وجود دارد یا خیر.

مجوز

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

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

isBackgroundTransparent()

اگر پس‌زمینه متن شفاف باشد، true ، در غیر این صورت false و در صورت وجود چندین استایل روی متن، null را برمی‌گرداند.

بازگشت

Boolean|null — مشخص می‌کند که آیا پس‌زمینه متن شفاف است یا خیر.

مجوز

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

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

isBold()

اگر متن به صورت پررنگ (bold) نمایش داده شود، true ، در غیر این صورت false و در صورت وجود چندین سبک (style) در متن، null را برمی‌گرداند.

بازگشت

Boolean|null — مشخص می‌کند که آیا متن به صورت پررنگ (bold) نمایش داده شود یا خیر.

مجوز

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

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

isItalic()

اگر متن ایتالیک باشد true ، در غیر این صورت false و در صورت وجود چندین استایل برای متن، null را برمی‌گرداند.

بازگشت

Boolean|null — مشخص می‌کند که آیا متن به صورت مورب نوشته شده است یا خیر.

مجوز

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

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

isSmallCaps()

اگر متن با حروف بزرگ کوچک نوشته شده باشد، true ، در غیر این صورت false و در صورت وجود چندین سبک (style) در متن، null را برمی‌گرداند.

بازگشت

Boolean|null — اینکه آیا متن با حروف بزرگ کوچک نوشته شده است یا خیر.

مجوز

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

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

isStrikethrough()

اگر متن خط خورده باشد true ، در غیر این صورت false و در صورت وجود چندین استایل برای متن، null را برمی‌گرداند.

بازگشت

Boolean|null — آیا متن خط خورده است یا خیر.

مجوز

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

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

isUnderline()

اگر متن زیرخط‌دار باشد true ، در غیر این صورت false و در صورت وجود چندین استایل برای متن، null را برمی‌گرداند.

بازگشت

Boolean|null — آیا متن زیرخط‌دار است یا خیر.

مجوز

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

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

یک Link حذف می‌کند.

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

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

setBackgroundColor(color)

رنگ پس زمینه متن را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
color Color رنگ پس‌زمینه برای تنظیم.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setBackgroundColor(red, green, blue)

رنگ پس‌زمینه متن را با مقادیر RGB داده شده از ۰ تا ۲۵۵ تنظیم می‌کند.

پارامترها

نام نوع توضیحات
red Integer جزء قرمز رنگ.
green Integer جزء سبز رنگ.
blue Integer جزء آبی رنگ.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setBackgroundColor(hexColor)

رنگ پس‌زمینه متن را با رشته رنگ هگز داده شده تنظیم می‌کند.

رشته هگز باید به فرمت '#RRGGBB' باشد. برای مثال، رنگ صورتی به صورت زیر نمایش داده می‌شود.

پارامترها

نام نوع توضیحات
hex Color String ریسمان شش رنگ.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setBackgroundColor(color)

رنگ پس‌زمینه متن را با ThemeColorType داده شده تنظیم می‌کند.

پارامترها

نام نوع توضیحات
color Theme Color Type نوع رنگ تم.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setBackgroundColorTransparent()

رنگ پس‌زمینه متن را شفاف تنظیم می‌کند.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setBaselineOffset(offset)

میزان انحراف عمودی متن نسبت به موقعیت عادی آن را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
offset Text Baseline Offset مقدار انحراف خط پایه برای تنظیم.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setBold(bold)

تعیین می‌کند که آیا متن باید به صورت پررنگ (bold) نمایش داده شود یا خیر.

پارامترها

نام نوع توضیحات
bold Boolean اینکه آیا متن به صورت پررنگ (بولد) نمایش داده شود یا خیر.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setFontFamily(fontFamily)

خانواده فونت متن را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
font Family String خانواده فونتی که باید تنظیم شود.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setFontFamilyAndWeight(fontFamily, fontWeight)

خانواده فونت و ضخامت متن را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
font Family String خانواده فونت.
font Weight Integer وزن فونت.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setFontSize(fontSize)

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

پارامترها

نام نوع توضیحات
font Size Number اندازه فونت بر حسب پوینت.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setForegroundColor(foregroundColor)

رنگ پیش‌زمینه متن را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
foreground Color Color رنگ پیش‌زمینه برای تنظیم.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setForegroundColor(red, green, blue)

رنگ پیش‌زمینه متن را با مقادیر RGB داده شده از ۰ تا ۲۵۵ تنظیم می‌کند.

پارامترها

نام نوع توضیحات
red Integer جزء قرمز رنگ.
green Integer جزء سبز رنگ.
blue Integer جزء آبی رنگ.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setForegroundColor(hexColor)

رنگ پیش‌زمینه متن را با رشته رنگ هگز داده شده تنظیم می‌کند.

رشته هگز باید به فرمت '#RRGGBB' باشد. برای مثال، رنگ صورتی به صورت زیر نمایش داده می‌شود.

پارامترها

نام نوع توضیحات
hex Color String ریسمان شش رنگ.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setForegroundColor(color)

رنگ پیش‌زمینه متن را با ThemeColorType داده شده تنظیم می‌کند.

پارامترها

نام نوع توضیحات
color Theme Color Type نوع رنگ تم.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setItalic(italic)

تنظیم می‌کند که آیا متن به صورت مورب (italic) نمایش داده شود یا خیر.

پارامترها

نام نوع توضیحات
italic Boolean اینکه آیا متن به صورت مورب (ایتالیک) نمایش داده شود یا خیر.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setLinkSlide(slideIndex)

با استفاده از اندیس مبتنی بر صفر اسلاید، Link به Slide داده شده تنظیم می‌کند.

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه ThemeColorType.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق setForegroundColor(hexColor) و setUnderline(underline) تغییر داد.

از آنجایی که نمی‌توان لینک‌ها را روی کاراکترهای خط جدید تنظیم کرد، کاراکترهای خط جدید در TextRange نادیده گرفته می‌شوند.

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

پارامترها

نام نوع توضیحات
slide Index Integer اندیس مبتنی بر صفر برای اسلاید.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setLinkSlide(slide)

یک Link به Slide داده شده تنظیم می‌کند، لینک توسط شناسه اسلاید داده شده تنظیم می‌شود.

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه ThemeColorType.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق setForegroundColor(hexColor) و setUnderline(underline) تغییر داد.

از آنجایی که نمی‌توان لینک‌ها را روی کاراکترهای خط جدید تنظیم کرد، کاراکترهای خط جدید در TextRange نادیده گرفته می‌شوند.

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(slide);

پارامترها

نام نوع توضیحات
slide Slide Slide که قرار است لینک شود.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setLinkSlide(slidePosition)

با استفاده از موقعیت نسبی اسلاید، Link به Slide داده شده تنظیم می‌کند.

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه ThemeColorType.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق setForegroundColor(hexColor) و setUnderline(underline) تغییر داد.

از آنجایی که نمی‌توان لینک‌ها را روی کاراکترهای خط جدید تنظیم کرد، کاراکترهای خط جدید در TextRange نادیده گرفته می‌شوند.

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

پارامترها

نام نوع توضیحات
slide Position Slide Position Slide Position نسبی.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setLinkUrl(url)

یک Link به رشته URL غیر خالی داده شده تنظیم می‌کند.

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه ThemeColorType.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق setForegroundColor(hexColor) و setUnderline(underline) تغییر داد.

از آنجایی که نمی‌توان لینک‌ها را روی کاراکترهای خط جدید تنظیم کرد، کاراکترهای خط جدید در TextRange نادیده گرفته می‌شوند.

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

پارامترها

نام نوع توضیحات
url String رشته‌ی URL.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setSmallCaps(smallCaps)

تنظیم می‌کند که آیا متن با حروف بزرگ کوچک نمایش داده شود یا خیر.

پارامترها

نام نوع توضیحات
small Caps Boolean اینکه آیا متن با حروف بزرگ کوچک نمایش داده شود یا خیر.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setStrikethrough(strikethrough)

تعیین می‌کند که آیا متن خط خورده باشد یا خیر.

پارامترها

نام نوع توضیحات
strikethrough Boolean اینکه آیا متن را خط بزنید یا خیر.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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

setUnderline(underline)

تنظیم می‌کند که آیا متن زیرخط‌دار باشد یا خیر.

پارامترها

نام نوع توضیحات
underline Boolean اینکه آیا متن را زیر خط بکشید یا خیر.

بازگشت

TextStyle — این TextStyle ، برای زنجیره‌سازی.

مجوز

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

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