סגנון הטקסט.
שיטות קריאה במחלקה הזו מחזירות null אם הטווח המתאים של Text משתרע על כמה רצפים של טקסט, ולרצפים האלה יש ערכים שונים לשיטת הקריאה שמופעלת. כדי להימנע מכך, צריך להריץ שאילתה לגבי סגנונות טקסט באמצעות Text שמוחזרים על ידי השיטה Text.
אם משתמשים בשיטות שמשנות את האופן שבו הטקסט מתאים לצורה, כל הגדרות ההתאמה האוטומטית שמוחלות על סגנונות הטקסט מושבתות.
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | Color|null | הפונקציה מחזירה את צבע הרקע של הטקסט, או null אם יש כמה סגנונות בטקסט. |
get | Text | הפונקציה מחזירה את ההיסט האנכי של הטקסט מהמיקום הרגיל שלו, או null אם יש כמה סגנונות בטקסט. |
get | String|null | הפונקציה מחזירה את משפחת הגופנים של הטקסט, או null אם יש כמה סגנונות בטקסט. |
get | Number|null | הפונקציה מחזירה את גודל הגופן של הטקסט בנקודות, או null אם יש כמה סגנונות בטקסט. |
get | Integer|null | הפונקציה מחזירה את עובי הגופן של הטקסט, או null אם יש כמה סגנונות בטקסט. |
get | Color|null | הפונקציה מחזירה את צבע החזית של הטקסט, או null אם יש כמה סגנונות בטקסט. |
get | Link|null | הפונקציה מחזירה את Link בטקסט, או null אם אין קישור או אם הקישור הוא לחלק מהטקסט או אם יש כמה קישורים. |
has | Boolean|null | הפונקציה מחזירה true אם יש קישור בטקסט, false אם אין קישור, או null אם הקישור הוא לחלק מהטקסט או אם יש כמה קישורים. |
is | Boolean|null | הפונקציה מחזירה true אם הרקע של הטקסט שקוף, false אם לא, או null אם יש כמה סגנונות בטקסט. |
is | Boolean|null | הפונקציה מחזירה true אם הטקסט מוצג כמודגש, false אם לא, או null אם יש כמה סגנונות בטקסט. |
is | Boolean|null | הפונקציה מחזירה true אם הטקסט מוטה, false אם לא, או null אם יש כמה סגנונות בטקסט. |
is | Boolean|null | הפונקציה מחזירה true אם הטקסט הוא באותיות קטנות, false אם לא, או null אם יש כמה סגנונות בטקסט. |
is | Boolean|null | הפונקציה מחזירה true אם הטקסט מודגש, false אם לא, או null אם יש כמה סגנונות בטקסט. |
is | Boolean|null | הפונקציה מחזירה true אם הטקסט מודגש, false אם לא, או null אם יש כמה סגנונות בטקסט. |
remove | Text | הסרה של Link. |
set | Text | הגדרת צבע הרקע של הטקסט. |
set | Text | מגדיר את צבע הרקע של הטקסט לערכי ה-RGB הנתונים מ-0 עד 255. |
set | Text | מגדיר את צבע הרקע של הטקסט למחרוזת צבע הקסדצימלית שצוינה. |
set | Text | מגדיר את צבע הרקע של הטקסט לערך Theme שצוין. |
set | Text | מגדיר את צבע הרקע של הטקסט כשקוף. |
set | Text | מגדיר את ההיסט האנכי של הטקסט ביחס למיקום הרגיל שלו. |
set | Text | קובעת אם הטקסט יוצג כמודגש. |
set | Text | הגדרת משפחת הגופנים של הטקסט . |
set | Text | הגדרת משפחת הגופנים והמשקל של הטקסט. |
set | Text | מגדיר את גודל הגופן של הטקסט בנקודות. |
set | Text | הגדרת צבע החזית של הטקסט. |
set | Text | הגדרת צבע החזית של הטקסט לערכי ה-RGB הנתונים מ-0 עד 255. |
set | Text | מגדיר את צבע החזית של הטקסט למחרוזת הצבע ההקסהדצימלית שצוינה. |
set | Text | הגדרת הצבע הקדמי של הטקסט לערך Theme שצוין. |
set | Text | הגדרת הטקסט כנטוי. |
set | Text | מגדיר את Link לערך Slide שצוין באמצעות אינדקס השקף שמתחיל בספרה אפס. |
set | Text | מגדיר Link לערך Slide שצוין, הקישור מוגדר לפי מזהה השקף שצוין. |
set | Text | מגדירים Link לערך Slide באמצעות המיקום היחסי של השקף. |
set | Text | מגדיר Link למחרוזת כתובת ה-URL הלא ריקה שצוינה. |
set | Text | הגדרה שקובעת אם הטקסט מוצג באותיות רישיות קטנות. |
set | Text | הגדרת קו חוצה לטקסט. |
set | Text | מגדירים אם הטקסט יהיה עם קו תחתון. |
תיעוד מפורט
get Background Color()
get Baseline Offset()
הפונקציה מחזירה את ההיסט האנכי של הטקסט מהמיקום הרגיל שלו, או null אם יש כמה סגנונות בטקסט.
חזרה
Text
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Font Family()
הפונקציה מחזירה את משפחת הגופנים של הטקסט, או null אם יש כמה סגנונות בטקסט.
חזרה
String|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Font Size()
הפונקציה מחזירה את גודל הגופן של הטקסט בנקודות, או null אם יש כמה סגנונות בטקסט.
חזרה
Number|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Font Weight()
הפונקציה מחזירה את עובי הגופן של הטקסט, או null אם יש כמה סגנונות בטקסט.
המשקל הוא כפולה של 100 בין 100 ל-900, כולל. הטווח הזה תואם לערכים המספריים שמתוארים במפרט CSS 2.1, בקטע 15.6, וערכים לא מספריים אסורים. משקלים שגדולים מ-700 או שווים לו נחשבים כמשקלים מודגשים, ובמקרה כזה הפונקציה is מחזירה true. ערך ברירת המחדל הוא 400 ("רגיל").
חזרה
Integer|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Foreground Color()
get Link()
הפונקציה מחזירה את Link בטקסט, או null אם אין קישור או אם הקישור הוא לחלק מהטקסט או אם יש כמה קישורים. כדי לברר אם הטקסט לא מכיל קישור, צריך להתקשר אל has.
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
has Link()
הפונקציה מחזירה true אם יש קישור בטקסט, false אם אין קישור, או null אם הקישור הוא לחלק מהטקסט או אם יש כמה קישורים.
אי אפשר להגדיר קישורים על תווי מעבר לשורה חדשה. לכן, אם המחרוזת Text מכילה תו של שורה חדשה, הפונקציה הזו תמיד מחזירה null או false.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Background Transparent()
הפונקציה מחזירה true אם הרקע של הטקסט שקוף, false אם לא, או null אם יש כמה סגנונות בטקסט.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Bold()
הפונקציה מחזירה true אם הטקסט מוצג כמודגש, false אם לא, או null אם יש כמה סגנונות בטקסט.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Italic()
הפונקציה מחזירה true אם הטקסט מוטה, false אם לא, או null אם יש כמה סגנונות בטקסט.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Small Caps()
הפונקציה מחזירה true אם הטקסט הוא באותיות קטנות, false אם לא, או null אם יש כמה סגנונות בטקסט.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Strikethrough()
הפונקציה מחזירה true אם הטקסט מודגש, false אם לא, או null אם יש כמה סגנונות בטקסט.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Underline()
הפונקציה מחזירה true אם הטקסט מודגש, false אם לא, או null אם יש כמה סגנונות בטקסט.
חזרה
Boolean|null
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
remove Link()
set Background Color(color)
set Background Color(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
set Background Color(hexColor)
מגדיר את צבע הרקע של הטקסט למחרוזת צבע הקסדצימלית שצוינה.
מחרוזת הקסדצימלית צריכה להיות בפורמט #RRGGBB. לדוגמה, ורוד מיוצג באמצעות '#FFC0CB'.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
hex | String |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Background Color(color)
מגדיר את צבע הרקע של הטקסט לערך Theme שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
color | Theme |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Background Color Transparent()
set Baseline Offset(offset)
מגדיר את ההיסט האנכי של הטקסט ביחס למיקום הרגיל שלו.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
offset | Text |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Bold(bold)
קובעת אם הטקסט יוצג כמודגש.
שינוי ההדגשה של הטקסט מעדכן את משקל הגופן שמשמש לעיבוד הטקסט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
bold | Boolean |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Font Family(fontFamily)
set Font Family And Weight(fontFamily, fontWeight)
הגדרת משפחת הגופנים והמשקל של הטקסט.
המשקל הוא כפולה של 100 בין 100 ל-900, כולל. הטווח הזה תואם לערכים המספריים שמתוארים במפרט CSS 2.1, בקטע 15.6, וערכים לא מספריים אסורים. משקלים שגדולים מ-700 או שווים לו נחשבים כמשקלים מודגשים, ובמקרה כזה הפונקציה is מחזירה true. ערך ברירת המחדל הוא 400 ("רגיל").
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
font | String | |
font | Integer |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Font Size(fontSize)
set Foreground Color(foregroundColor)
set Foreground Color(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
set Foreground Color(hexColor)
מגדיר את צבע החזית של הטקסט למחרוזת הצבע ההקסהדצימלית שצוינה.
מחרוזת הקסדצימלית צריכה להיות בפורמט #RRGGBB. לדוגמה, ורוד מיוצג באמצעות '#FFC0CB'.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
hex | String |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Foreground Color(color)
הגדרת הצבע הקדמי של הטקסט לערך Theme שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
color | Theme |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Italic(italic)
set Link Slide(slideIndex)
מגדיר את Link לערך Slide שצוין באמצעות אינדקס השקף שמתחיל בספרה אפס.
הגדרת קישור משנה את סגנון הטקסט כך שיופיע קו תחתון וצבע חזית Theme. אפשר לשנות את זה דרך set וset.
אי אפשר להגדיר קישורים על תווי מעבר לשורה חדשה, ולכן המערכת מתעלמת מתווי מעבר לשורה חדשה ב-Text.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
slide | Integer | האינדקס של השקף, כשהספירה מתחילה מ-0. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Link Slide(slide)
מגדיר Link לערך Slide שצוין, הקישור מוגדר לפי מזהה השקף שצוין.
הגדרת קישור משנה את סגנון הטקסט כך שיופיע קו תחתון וצבע חזית Theme. אפשר לשנות את זה דרך set וset.
אי אפשר להגדיר קישורים על תווי מעבר לשורה חדשה, ולכן המערכת מתעלמת מתווי מעבר לשורה חדשה ב-Text.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
slide | Slide | ה-Slide שיש לקשר. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Link Slide(slidePosition)
מגדירים Link לערך Slide באמצעות המיקום היחסי של השקף.
הגדרת קישור משנה את סגנון הטקסט כך שיופיע קו תחתון וצבע חזית Theme. אפשר לשנות את זה דרך set וset.
אי אפשר להגדיר קישורים על תווי מעבר לשורה חדשה, ולכן המערכת מתעלמת מתווי מעבר לשורה חדשה ב-Text.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
slide | Slide | הערך היחסי Slide. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Link Url(url)
מגדיר Link למחרוזת כתובת ה-URL הלא ריקה שצוינה.
הגדרת קישור משנה את סגנון הטקסט כך שיופיע קו תחתון וצבע החזית יהיה Theme. אפשר לשנות את זה דרך set וset.
אי אפשר להגדיר קישורים על תווי מעבר לשורה חדשה, ולכן המערכת מתעלמת מתווי מעבר לשורה חדשה ב-Text.
// Set a link to the URL. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkUrl('https://slides.google.com');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
url | String | מחרוזת כתובת ה-URL. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations