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