Class TextStyle

سبک متن

سبک متن.

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

مستندات دقیق

get Background Color()

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

بازگشت

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

مجوز

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

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

get Baseline Offset()

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

بازگشت

Text Baseline Offset |null — فاصله‌ی عمودی متن از موقعیت عادی آن.

مجوز

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

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

get Font Family()

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

بازگشت

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

مجوز

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

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

get Font Size()

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

بازگشت

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

مجوز

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

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

get Font Weight()

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

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

بازگشت

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

مجوز

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

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

get Foreground Color()

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

بازگشت

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

مجوز

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

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

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

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 را برمی‌گرداند.

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

بازگشت

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

مجوز

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

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

is Background Transparent()

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

بازگشت

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

مجوز

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

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

is Bold()

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

بازگشت

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

مجوز

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

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

is Italic()

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

بازگشت

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

مجوز

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

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

is Small Caps()

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

بازگشت

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

مجوز

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

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

is Strikethrough()

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

بازگشت

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

مجوز

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

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

is Underline()

اگر متن زیرخط‌دار باشد 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();

بازگشت

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

set Background Color(color)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Background Color(red, green, blue)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Background Color(hexColor)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Background Color(color)

رنگ پس‌زمینه متن را با نوع رنگ تم Theme Color Type تعیین می‌کند.

پارامترها

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

بازگشت

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

مجوز

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

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

set Background Color Transparent()

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

بازگشت

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

مجوز

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

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

set Baseline Offset(offset)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Bold(bold)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Font Family(fontFamily)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Font Family And Weight(fontFamily, fontWeight)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Font Size(fontSize)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Foreground Color(foregroundColor)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Foreground Color(red, green, blue)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Foreground Color(hexColor)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Foreground Color(color)

رنگ پیش‌زمینه متن را با نوع رنگ تم Theme Color Type تعیین می‌کند.

پارامترها

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

بازگشت

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

مجوز

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

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

set Italic(italic)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Link Slide(slideIndex)

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

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه‌ی Theme Color Type.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق set Foreground Color(hexColor) و set Underline(underline) تغییر داد.

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

// 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 اندیس مبتنی بر صفر برای اسلاید.

بازگشت

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

مجوز

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

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

set Link Slide(slide)

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

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه‌ی Theme Color Type.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق set Foreground Color(hexColor) و set Underline(underline) تغییر داد.

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

// 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 که قرار است لینک شود.

بازگشت

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

مجوز

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

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

set Link Slide(slidePosition)

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

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه‌ی Theme Color Type.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق set Foreground Color(hexColor) و set Underline(underline) تغییر داد.

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

// 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 نسبی.

بازگشت

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

مجوز

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

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

set Link Url(url)

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

تنظیم یک لینک، سبک متن را به زیرخط‌دار و رنگ پیش‌زمینه‌ی Theme Color Type.HYPERLINK تغییر می‌دهد. این را می‌توان از طریق set Foreground Color(hexColor) و set Underline(underline) تغییر داد.

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

// 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.

بازگشت

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

مجوز

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

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

set Small Caps(smallCaps)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Strikethrough(strikethrough)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Underline(underline)

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

پارامترها

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

بازگشت

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

مجوز

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

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