سبک متن.
متدهای خواندن در این کلاس اگر TextRange
متناظر شامل چندین اجرای متن باشد و آن اجراها مقادیر متفاوتی برای متد خوانده شده فراخوانی داشته باشند، null
برمیگردانند. برای جلوگیری از این امر، استایل های متن را با استفاده از TextRange
که توسط متد TextRange.getRuns()
برگردانده شده است، جستجو کنید.
اگر از روشهایی استفاده میکنید که نحوه تناسب متن را در یک شکل ویرایش میکنند، هر گونه تنظیمات تناسب خودکار اعمال شده در سبکهای متن غیرفعال میشود.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
getBackgroundColor() | Color | رنگ پسزمینه متن را برمیگرداند یا اگر چند سبک روی متن وجود داشته باشد null . |
getBaselineOffset() | TextBaselineOffset | افست عمودی متن را از موقعیت معمولی آن برمیگرداند، یا اگر چند سبک روی متن وجود داشته باشد null . |
getFontFamily() | String | خانواده فونت متن را برمیگرداند یا اگر چند سبک روی متن وجود داشته باشد null برمیگرداند. |
getFontSize() | Number | اندازه فونت متن را بر حسب نقطه برمیگرداند یا اگر چند سبک روی متن وجود داشته باشد null . |
getFontWeight() | Integer | وزن فونت متن را برمیگرداند یا در صورت وجود چند سبک روی متن، null برمیگرداند. |
getForegroundColor() | Color | رنگ پیشزمینه متن را برمیگرداند یا اگر چند سبک روی متن وجود داشته باشد null . |
getLink() | Link | Link را روی متن برمیگرداند، یا اگر پیوندی وجود نداشته باشد یا اگر پیوند در بخشی از متن باشد یا چندین پیوند وجود داشته باشد، null . |
hasLink() | Boolean | اگر پیوندی روی متن وجود داشته باشد، true ، اگر لینک وجود نداشته باشد، false ، یا اگر پیوند در بخشی از متن باشد یا چندین پیوند وجود داشته باشد، null برمیگرداند. |
isBackgroundTransparent() | Boolean | اگر پسزمینه متن شفاف باشد، true ، در غیر این صورت false ، یا اگر چند سبک روی متن وجود داشته باشد، null برمیگرداند. |
isBold() | Boolean | اگر متن به صورت پررنگ، false در غیر این صورت، یا اگر چند سبک در متن وجود دارد، null true . |
isItalic() | Boolean | اگر متن به صورت ایتالیک باشد، true ، اگر نه false ، یا اگر چند سبک روی متن وجود داشته باشد، null برمیگرداند. |
isSmallCaps() | Boolean | اگر متن با حروف کوچک کوچک باشد true ، اگر نه false و اگر چند سبک روی متن وجود داشته باشد null برمیگرداند. |
isStrikethrough() | Boolean | اگر متن خط خورده باشد true ، در غیر این صورت false یا اگر چند سبک روی متن وجود داشته باشد null برمیگرداند. |
isUnderline() | Boolean | اگر متن زیر خط کشیده شده باشد true ، در غیر این صورت false یا اگر چند سبک روی متن وجود داشته باشد null برمی گرداند. |
removeLink() | TextStyle | یک Link حذف می کند. |
setBackgroundColor(color) | TextStyle | رنگ پس زمینه متن را تنظیم می کند. |
setBackgroundColor(red, green, blue) | TextStyle | رنگ پس زمینه متن را روی مقادیر داده شده RGB از 0 تا 255 تنظیم می کند. |
setBackgroundColor(hexColor) | TextStyle | رنگ پسزمینه متن را روی رشته رنگی هگزا داده شده تنظیم میکند. |
setBackgroundColor(color) | TextStyle | رنگ پس زمینه متن را روی ThemeColorType داده شده تنظیم می کند. |
setBackgroundColorTransparent() | TextStyle | رنگ پس زمینه متن را شفاف تنظیم می کند. |
setBaselineOffset(offset) | TextStyle | افست عمودی متن را نسبت به موقعیت عادی آن تنظیم می کند. |
setBold(bold) | TextStyle | تنظیم می کند که آیا متن باید به صورت پررنگ ارائه شود یا خیر. |
setFontFamily(fontFamily) | TextStyle | خانواده فونت متن را تنظیم می کند. |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | خانواده فونت و وزن متن را تنظیم می کند. |
setFontSize(fontSize) | TextStyle | اندازه فونت متن را بر حسب نقطه تنظیم می کند. |
setForegroundColor(foregroundColor) | TextStyle | رنگ پیش زمینه متن را تنظیم می کند. |
setForegroundColor(red, green, blue) | TextStyle | رنگ پیش زمینه متن را روی مقادیر داده شده RGB از 0 تا 255 تنظیم می کند. |
setForegroundColor(hexColor) | TextStyle | رنگ پیش زمینه متن را روی رشته رنگی شش گوش داده شده تنظیم می کند. |
setForegroundColor(color) | TextStyle | رنگ پیش زمینه متن را روی ThemeColorType داده شده تنظیم می کند. |
setItalic(italic) | TextStyle | ایتالیک بودن متن را تنظیم می کند. |
setLinkSlide(slideIndex) | TextStyle | با استفاده از شاخص مبتنی بر صفر Slide ، Link به اسلاید داده شده تنظیم می کند. |
setLinkSlide(slide) | TextStyle | Link به Slide داده شده تنظیم می کند، پیوند توسط شناسه اسلاید داده شده تنظیم می شود. |
setLinkSlide(slidePosition) | TextStyle | با استفاده از موقعیت نسبی اسلاید، Link را به Slide داده شده تنظیم می کند. |
setLinkUrl(url) | TextStyle | یک Link به رشته URL غیر خالی داده شده تنظیم می کند. |
setSmallCaps(smallCaps) | TextStyle | تنظیم می کند که آیا متن با حروف کوچک نمایش داده می شود. |
setStrikethrough(strikethrough) | TextStyle | تعیین می کند که آیا متن از طریق خط زده شده است یا خیر. |
setUnderline(underline) | TextStyle | تعیین می کند که آیا متن زیر خط کشیده شود یا خیر. |
مستندات دقیق
getBackgroundColor()
getBaselineOffset()
افست عمودی متن را از موقعیت معمولی آن برمیگرداند، یا اگر چند سبک روی متن وجود داشته باشد null
.
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontFamily()
خانواده فونت متن را برمیگرداند یا اگر چند سبک روی متن وجود داشته باشد null
برمیگرداند.
برگشت
String
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontSize()
اندازه فونت متن را بر حسب نقطه برمیگرداند یا اگر چند سبک روی متن وجود داشته باشد null
.
برگشت
Number
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontWeight()
وزن فونت متن را برمیگرداند یا در صورت وجود چند سبک روی متن، null
برمیگرداند.
وزن مضربی از 100 بین 100 و 900، شامل. این محدوده با مقادیر عددی شرح داده شده در مشخصات CSS 2.1، بخش 15.6 مطابقت دارد و مقادیر غیر عددی مجاز نیستند. وزنهای بزرگتر یا مساوی 700 پررنگ در نظر گرفته میشوند، در این صورت isBold()
true
را برمیگرداند. مقدار پیش فرض 400 ("عادی") است.
برگشت
Integer
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getForegroundColor()
getLink()
Link
را روی متن برمیگرداند، یا اگر پیوندی وجود نداشته باشد یا اگر پیوند در بخشی از متن باشد یا چندین پیوند وجود داشته باشد، null
. برای تعیین اینکه آیا متن هیچ پیوندی ندارد hasLink()
را فراخوانی کنید.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
hasLink()
اگر پیوندی روی متن وجود داشته باشد، true
، اگر لینک وجود نداشته باشد، false
، یا اگر پیوند در بخشی از متن باشد یا چندین پیوند وجود داشته باشد، null
برمیگرداند.
پیوندها را نمی توان روی کاراکترهای خط جدید تنظیم کرد. بنابراین، اگر TextRange
حاوی یک کاراکتر خط جدید باشد، این متد همیشه null
یا false
را برمیگرداند.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isBackgroundTransparent()
اگر پسزمینه متن شفاف باشد، true
، در غیر این صورت false
، یا اگر چند سبک روی متن وجود داشته باشد، null
برمیگرداند.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isBold()
اگر متن به صورت پررنگ، false
در غیر این صورت، یا اگر چند سبک در متن وجود دارد، null
true
.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isItalic()
اگر متن به صورت ایتالیک باشد، true
، اگر نه false
، یا اگر چند سبک روی متن وجود داشته باشد، null
برمیگرداند.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isSmallCaps()
اگر متن با حروف کوچک کوچک باشد true
، اگر نه false
و اگر چند سبک روی متن وجود داشته باشد null
برمیگرداند.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isStrikethrough()
اگر متن خط خورده باشد true
، در غیر این صورت false
یا اگر چند سبک روی متن وجود داشته باشد null
برمیگرداند.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isUnderline()
اگر متن زیر خط کشیده شده باشد true
، در غیر این صورت false
یا اگر چند سبک روی متن وجود داشته باشد null
برمی گرداند.
برگشت
Boolean
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
رنگ پس زمینه متن را روی مقادیر داده شده RGB از 0 تا 255 تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(hexColor)
رنگ پسزمینه متن را روی رشته رنگی هگزا داده شده تنظیم میکند.
رشته هگز باید در قالب «#RRGGBB» باشد. به عنوان مثال، صورتی به عنوان "#FFC0CB" نشان داده می شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
hexColor | String |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(color)
رنگ پس زمینه متن را روی ThemeColorType
داده شده تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
color | ThemeColorType |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
افست عمودی متن را نسبت به موقعیت عادی آن تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
offset | TextBaselineOffset |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBold(bold)
تنظیم می کند که آیا متن باید به صورت پررنگ ارائه شود یا خیر.
تغییر درشت متن، وزن فونت مورد استفاده برای ارائه متن را به روز می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
bold | Boolean |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontFamily(fontFamily)
خانواده فونت متن را تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
fontFamily | String |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontFamilyAndWeight(fontFamily, fontWeight)
خانواده فونت و وزن متن را تنظیم می کند.
وزن مضربی از 100 بین 100 و 900، شامل. این محدوده با مقادیر عددی شرح داده شده در مشخصات CSS 2.1، بخش 15.6 مطابقت دارد و مقادیر غیر عددی مجاز نیستند. وزنهای بزرگتر یا مساوی 700 پررنگ در نظر گرفته میشوند، در این صورت isBold()
true
را برمیگرداند. مقدار پیش فرض 400 ("عادی") است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontSize(fontSize)
اندازه فونت متن را بر حسب نقطه تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
fontSize | Number |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(foregroundColor)
setForegroundColor(red, green, blue)
رنگ پیش زمینه متن را روی مقادیر داده شده RGB از 0 تا 255 تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(hexColor)
رنگ پیش زمینه متن را روی رشته رنگی شش گوش داده شده تنظیم می کند.
رشته هگز باید در قالب «#RRGGBB» باشد. به عنوان مثال، صورتی به عنوان "#FFC0CB" نشان داده می شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
hexColor | String |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(color)
رنگ پیش زمینه متن را روی ThemeColorType
داده شده تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
color | ThemeColorType |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setItalic(italic)
setLinkSlide(slideIndex)
با استفاده از شاخص مبتنی بر صفر Slide
، Link
به اسلاید داده شده تنظیم می کند.
تنظیم یک پیوند، سبک متن را تغییر می دهد تا زیر خط کشیده شود و رنگ پیش زمینه ThemeColorType.HYPERLINK
داشته باشد. این را می توان از طریق setForegroundColor(hexColor)
و setUnderline(underline)
تغییر داد.
از آنجایی که پیوندها را نمی توان روی کاراکترهای خط جدید تنظیم کرد، کاراکترهای خط جدید در TextRange
نادیده گرفته می شوند.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
slideIndex | Integer | شاخص مبتنی بر صفر به اسلاید. |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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. var slide = presentation.getSlides()[0]; text.getTextStyle().setLinkSlide(slide);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
slide | Slide | Slide که باید پیوند داده شود. |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
slidePosition | SlidePosition | SlidePosition نسبی . |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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. text.getTextStyle().setLinkUrl("https://slides.google.com");
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
url | String | رشته URL. |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setSmallCaps(smallCaps)
تنظیم می کند که آیا متن با حروف کوچک نمایش داده می شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
smallCaps | Boolean |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStrikethrough(strikethrough)
تعیین می کند که آیا متن از طریق خط زده شده است یا خیر.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
strikethrough | Boolean |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setUnderline(underline)
تعیین می کند که آیا متن زیر خط کشیده شود یا خیر.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
underline | Boolean |
برگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations