Class TextStyle

TextStyle

סגנון הטקסט.

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

חזרה

‫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