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

مجوز

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

  • 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

set Background Color(color)

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

پارامترها

نام نوع توضیحات
color Color

بازگشت

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

مجوز

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

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

set Background Color(hexColor)

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

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

پارامترها

نام نوع توضیحات
hex Color String

بازگشت

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

مجوز

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

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

set Background Color Transparent()

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

بازگشت

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

مجوز

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

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

set Bold(bold)

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

تغییر میزان پررنگی متن، وزن فونت مورد استفاده برای رندر متن را به‌روزرسانی می‌کند.

پارامترها

نام نوع توضیحات
bold Boolean

بازگشت

Text Style

مجوز

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

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

set Font Family(fontFamily)

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

پارامترها

نام نوع توضیحات
font Family String

بازگشت

Text Style

مجوز

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

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

set Font Family And Weight(fontFamily, fontWeight)

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

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

پارامترها

نام نوع توضیحات
font Family String
font Weight Integer

بازگشت

Text Style

مجوز

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

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

set Font Size(fontSize)

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

پارامترها

نام نوع توضیحات
font Size Number

بازگشت

Text Style

مجوز

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

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

set Foreground Color(foregroundColor)

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

پارامترها

نام نوع توضیحات
foreground Color Color

بازگشت

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

مجوز

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

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

set Foreground Color(hexColor)

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

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

پارامترها

نام نوع توضیحات
hex Color String

بازگشت

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

مجوز

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

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

set Italic(italic)

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

پارامترها

نام نوع توضیحات
italic Boolean

بازگشت

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

مجوز

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

  • 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

مجوز

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

  • 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

مجوز

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

  • 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

مجوز

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

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

set Small Caps(smallCaps)

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

پارامترها

نام نوع توضیحات
small Caps Boolean

بازگشت

Text Style

مجوز

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

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

set Strikethrough(strikethrough)

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

پارامترها

نام نوع توضیحات
strikethrough Boolean

بازگشت

Text Style

مجوز

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

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

set Underline(underline)

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

پارامترها

نام نوع توضیحات
underline Boolean

بازگشت

Text Style

مجوز

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

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