Class TextStyle

TextStyle

סגנון הטקסט.

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

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

Methods

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

אישור

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

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

getBaselineOffset()

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

חזרה

TextBaselineOffset

אישור

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

  • 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 ('normal').

חזרה

Integer

אישור

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

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

getForegroundColor()

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

חזרה

Color

אישור

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

  • 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

אישור

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

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

הפונקציה מחזירה את הערך 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()

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

חזרה

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

הסרה של Link.

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

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

חזרה

TextStyle

setBackgroundColor(color)

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

פרמטרים

שםסוגתיאור
colorColor

חזרה

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

אישור

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

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

setBackgroundColor(hexColor)

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

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

פרמטרים

שםסוגתיאור
hexColorString

חזרה

TextStyle

אישור

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

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

setBackgroundColor(color)

מגדיר את צבע הרקע של הטקסט כ-ThemeColorType.

פרמטרים

שםסוגתיאור
colorThemeColorType

חזרה

TextStyle

אישור

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

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

setBackgroundColorTransparent()

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

חזרה

TextStyle

אישור

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

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

setBaselineOffset(offset)

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

פרמטרים

שםסוגתיאור
offsetTextBaselineOffset

חזרה

TextStyle

אישור

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

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

setBold(bold)

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

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

פרמטרים

שםסוגתיאור
boldBoolean

חזרה

TextStyle

אישור

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

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

setFontFamily(fontFamily)

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

פרמטרים

שםסוגתיאור
fontFamilyString

חזרה

TextStyle

אישור

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

  • 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 ('normal').

פרמטרים

שםסוגתיאור
fontFamilyString
fontWeightInteger

חזרה

TextStyle

אישור

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

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

setFontSize(fontSize)

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

פרמטרים

שםסוגתיאור
fontSizeNumber

חזרה

TextStyle

אישור

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

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

setForegroundColor(foregroundColor)

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

פרמטרים

שםסוגתיאור
foregroundColorColor

חזרה

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

אישור

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

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

setForegroundColor(hexColor)

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

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

פרמטרים

שםסוגתיאור
hexColorString

חזרה

TextStyle

אישור

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

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

setForegroundColor(color)

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

פרמטרים

שםסוגתיאור
colorThemeColorType

חזרה

TextStyle

אישור

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

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

setItalic(italic)

מגדיר אם הטקסט יהיה נטוי.

פרמטרים

שםסוגתיאור
italicBoolean

חזרה

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האינדקס של השקף, שמתחיל בספרה אפס.

חזרה

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

אישור

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

  • 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

אישור

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

  • 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

אישור

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

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

setSmallCaps(smallCaps)

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

פרמטרים

שםסוגתיאור
smallCapsBoolean

חזרה

TextStyle

אישור

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

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

setStrikethrough(strikethrough)

מגדיר אם הטקסט יהיה מקווקו.

פרמטרים

שםסוגתיאור
strikethroughBoolean

חזרה

TextStyle

אישור

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

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

setUnderline(underline)

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

פרמטרים

שםסוגתיאור
underlineBoolean

חזרה

TextStyle

אישור

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

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