Class TextStyle

טקסטסגנון

סגנון הטקסט.

שיטות קריאה במחלקה הזו מחזירות null אם ה-TextRange המתאים משתרע על כמה רצפים של טקסט, ולרצפים האלה יש ערכים שונים לשיטת הקריאה שמופעלת. כדי להימנע מכך, צריך להריץ שאילתה לגבי סגנונות טקסט באמצעות TextRange שמוחזר על ידי השיטה TextRange.getRuns().

אם משתמשים בשיטות שמשנות את האופן שבו הטקסט מתאים לצורה, כל ההגדרות של ההתאמה האוטומטית שחלות על סגנונות הטקסט מושבתות.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
getBackgroundColor()Color|nullהפונקציה מחזירה את צבע הרקע של הטקסט, או null אם יש כמה סגנונות בטקסט.
getBaselineOffset()TextBaselineOffset|nullהפונקציה מחזירה את ההיסט האנכי של הטקסט מהמיקום הרגיל שלו, או null אם יש כמה סגנונות בטקסט.
getFontFamily()String|nullהפונקציה מחזירה את משפחת הגופנים של הטקסט, או null אם יש כמה סגנונות בטקסט.
getFontSize()Number|nullהפונקציה מחזירה את גודל הגופן של הטקסט בנקודות, או null אם יש כמה סגנונות בטקסט.
getFontWeight()Integer|nullהפונקציה מחזירה את עובי הגופן של הטקסט, או null אם יש כמה סגנונות בטקסט.
getForegroundColor()Color|nullהפונקציה מחזירה את צבע החזית של הטקסט, או null אם יש כמה סגנונות בטקסט.
getLink()Link|nullהפונקציה מחזירה את Link בטקסט, או null אם אין קישור או אם הקישור הוא לחלק מהטקסט או אם יש כמה קישורים.
hasLink()Boolean|nullהפונקציה מחזירה true אם יש קישור בטקסט, false אם אין קישור, או null אם הקישור הוא לחלק מהטקסט או אם יש קישורים מרובים.
isBackgroundTransparent()Boolean|nullהפונקציה מחזירה true אם הרקע של הטקסט שקוף, false אם לא, או null אם יש כמה סגנונות בטקסט.
isBold()Boolean|nullהפונקציה מחזירה true אם הטקסט מוצג כמודגש, false אם לא, או null אם יש כמה סגנונות בטקסט.
isItalic()Boolean|nullהפונקציה מחזירה true אם הטקסט מוטה, false אם לא, או null אם יש לטקסט כמה סגנונות.
isSmallCaps()Boolean|nullהפונקציה מחזירה true אם הטקסט הוא באותיות קטנות, false אם לא, או null אם יש כמה סגנונות בטקסט.
isStrikethrough()Boolean|nullהפונקציה מחזירה true אם הטקסט מודגש, false אם לא, או null אם יש כמה סגנונות בטקסט.
isUnderline()Boolean|nullהפונקציה מחזירה 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מגדיר את Link לערך Slide שצוין באמצעות אינדקס השקף שמתחיל בספרה אפס.
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()

הפונקציה מחזירה את צבע הרקע של הטקסט, או 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 אם יש כמה סגנונות בטקסט.

המשקל הוא כפולה של 100 בין 100 ל-900, כולל. הטווח הזה תואם לערכים המספריים שמתוארים במפרט CSS 2.1, בקטע 15.6, וערכים לא מספריים אסורים. משקלים שגדולים מ-700 או שווים לו נחשבים כמשקלים מודגשים, ובמקרה כזה הפונקציה isBold() מחזירה true. ערך ברירת המחדל הוא 400 ("normal").

חזרה

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

הפונקציה מחזירה true אם הטקסט מוצג כמודגש, false אם לא, או null אם יש כמה סגנונות בטקסט.

חזרה

‫Boolean|null — אם הטקסט מוצג כמודגש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • 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 אם לא, או 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)

הגדרת צבע הרקע של הטקסט.

פרמטרים

שםסוגתיאור
colorColorצבע הרקע שרוצים להגדיר.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setBackgroundColor(red, green, blue)

מגדיר את צבע הרקע של הטקסט לערכי ה-RGB שצוינו, מ-0 עד 255.

פרמטרים

שםסוגתיאור
redIntegerרכיב האדום של הצבע.
greenIntegerהרכיב הירוק של הצבע.
blueIntegerהרכיב הכחול של הצבע.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setBackgroundColor(hexColor)

מגדיר את צבע הרקע של הטקסט למחרוזת צבע הקסדצימלית שצוינה.

מחרוזת הקסדצימלית צריכה להיות בפורמט ‎#RRGGBB. לדוגמה, הצבע הוורוד מיוצג באמצעות

פרמטרים

שםסוגתיאור
hexColorStringמחרוזת הקסדצימלית של הצבע.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setBackgroundColor(color)

מגדיר את צבע הרקע של הטקסט לערך ThemeColorType שצוין.

פרמטרים

שםסוגתיאור
colorThemeColorTypeסוג צבע העיצוב.

חזרה

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

הגדרת ההיסט האנכי של הטקסט ביחס למיקום הרגיל שלו.

פרמטרים

שםסוגתיאור
offsetTextBaselineOffsetההיסט של קו הבסיס שרוצים להגדיר.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setBold(bold)

קובעת אם הטקסט יוצג כמודגש.

פרמטרים

שםסוגתיאור
boldBooleanהאם להציג את הטקסט בגופן מודגש.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setFontFamily(fontFamily)

הגדרת משפחת הגופנים של הטקסט .

פרמטרים

שםסוגתיאור
fontFamilyStringמשפחת הגופנים להגדרה.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setFontFamilyAndWeight(fontFamily, fontWeight)

הגדרת משפחת הגופנים ועובי הגופן של הטקסט.

פרמטרים

שםסוגתיאור
fontFamilyStringמשפחת הגופנים.
fontWeightIntegerמשקל הגופן.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setFontSize(fontSize)

מגדיר את גודל הגופן של הטקסט בנקודות.

פרמטרים

שםסוגתיאור
fontSizeNumberגודל הגופן בנקודות.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setForegroundColor(foregroundColor)

הגדרת צבע החזית של הטקסט.

פרמטרים

שםסוגתיאור
foregroundColorColorצבע החזית שצריך להגדיר.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setForegroundColor(red, green, blue)

הגדרת צבע החזית של הטקסט לערכי ה-RGB הנתונים מ-0 עד 255.

פרמטרים

שםסוגתיאור
redIntegerרכיב האדום של הצבע.
greenIntegerהרכיב הירוק של הצבע.
blueIntegerהרכיב הכחול של הצבע.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setForegroundColor(hexColor)

מגדיר את צבע החזית של הטקסט למחרוזת הצבע ההקסהדצימלית שצוינה.

מחרוזת הקסדצימלית צריכה להיות בפורמט ‎#RRGGBB. לדוגמה, הצבע הוורוד מיוצג באמצעות

פרמטרים

שםסוגתיאור
hexColorStringמחרוזת הקסדצימלית של הצבע.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setForegroundColor(color)

מגדיר את צבע הטקסט הקדמי לערך ThemeColorType שצוין.

פרמטרים

שםסוגתיאור
colorThemeColorTypeסוג צבע העיצוב.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setItalic(italic)

הגדרת הטקסט כנטוי.

פרמטרים

שםסוגתיאור
italicBooleanהאם להציג את הטקסט בכתב נטוי.

חזרה

‫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);

פרמטרים

שםסוגתיאור
slideIndexIntegerהאינדקס של השקף, כשהספירה מתחילה מ-0.

חזרה

‫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);

פרמטרים

שםסוגתיאור
slideSlideה-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);

פרמטרים

שםסוגתיאור
slidePositionSlidePositionהערך היחסי SlidePosition.

חזרה

‫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');

פרמטרים

שםסוגתיאור
urlStringמחרוזת כתובת ה-URL.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setSmallCaps(smallCaps)

המאפיין קובע אם הטקסט מוצג באותיות רישיות קטנות.

פרמטרים

שםסוגתיאור
smallCapsBooleanהאם להציג את הטקסט באותיות לועזיות קטנות.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setStrikethrough(strikethrough)

הגדרת קו חוצה לטקסט.

פרמטרים

שםסוגתיאור
strikethroughBooleanהאם להוסיף קו חוצה לטקסט.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setUnderline(underline)

מגדירים אם הטקסט יהיה עם קו תחתון.

פרמטרים

שםסוגתיאור
underlineBooleanהאם להוסיף קו תחתון לטקסט.

חזרה

‫TextStyle — TextStyle, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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