קטע של תוכן הטקסט של Shape
או TableCell
.
אם משתמשים בשיטות שעורכים את האופן שבו הטקסט נכנס לצורה, הגדרות ההתאמה האוטומטית שהוחלו על הצורה מושבתות.
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
appendParagraph(text) | Paragraph | מצרפת פסקה בסוף טווח הטקסט. |
appendRange(textRange) | TextRange | צירוף עותק של טווח הטקסט שצוין לסוף טווח הטקסט הנוכחי. |
appendRange(textRange, matchSourceFormatting) | TextRange | צירוף עותק של טווח הטקסט שצוין לסוף טווח הטקסט הנוכחי. |
appendText(text) | TextRange | מצרפת טקסט בסוף טווח הטקסט. |
asRenderedString() | String | מחזירה את הטקסט המעובד שתחום על ידי הטווח של הצורה המשויכת או תא הטבלה, בפורמט המתאים להצגה למשתמשי קצה. |
asString() | String | מחזירה את הטקסט הגולמי שתחום על ידי הטווח של הצורה או תא הטבלה המשויכים. |
clear() | void | ניקוי הטקסט שתחום בטווח הזה. |
clear(startOffset, endOffset) | void | מנקה את הטקסט שתחום על ידי היסט ההתחלה והסיום שבטווח. |
find(pattern) | TextRange[] | מחזירה את כל הטווחים התואמים לדפוס החיפוש בטווח הטקסט הנוכחי. |
find(pattern, startOffset) | TextRange[] | מחזירה את כל הטווחים שתואמים לדפוס החיפוש בטווח הטקסט הנוכחי, החל מהיסט ההתחלה. |
getAutoTexts() | AutoText[] | מחזירה את הטקסטים האוטומטיים בתוך טווח הטקסט הנוכחי. |
getEndIndex() | Integer | מחזירה את האינדקס הבלעדי, המבוסס על 0, עבור התו האחרון בטווח הזה. |
getLength() | Integer | מחזירה את מספר התווים בטווח. |
getLinks() | TextRange[] | הפונקציה מחזירה אוסף של טווחי טקסט שתואמים לכל Link בטווח הטקסט הנוכחי, או שחופפים לטווח הטקסט הנוכחי. |
getListParagraphs() | Paragraph[] | מחזירה את הפסקאות ברשימות שחופפות לטווח הטקסט הנוכחי. |
getListStyle() | ListStyle | מחזירה את ListStyle של טווח הטקסט הנוכחי. |
getParagraphStyle() | ParagraphStyle | מחזירה את ParagraphStyle של טווח הטקסט הנוכחי. |
getParagraphs() | Paragraph[] | מחזירה את הפסקאות שחופפות לטווח הטקסט הנוכחי. |
getRange(startOffset, endOffset) | TextRange | מחזירה TextRange חדש שמכסה חלק מהטווח שממנו הוא נגזר. |
getRuns() | TextRange[] | מחזירה את רצפי הטקסט שחופפת לטווח הטקסט הנוכחי. |
getStartIndex() | Integer | מחזירה את האינדקס הכולל, המבוסס על 0, עבור התו הראשון בטווח הזה. |
getTextStyle() | TextStyle | מחזירה את סגנון הטקסט של הטווח, או null אם הטווח ריק. |
insertParagraph(startOffset, text) | Paragraph | הוספת פסקה בקיזוז ההתחלה. |
insertRange(startOffset, textRange) | TextRange | הוספת עותק של טווח הטקסט שצוין בקיזוז ההתחלה. |
insertRange(startOffset, textRange, matchSourceFormatting) | TextRange | הוספת עותק של טווח הטקסט שצוין בקיזוז ההתחלה. |
insertText(startOffset, text) | TextRange | הוספת טקסט בקיזוז ההתחלה. |
isEmpty() | Boolean | הפונקציה מחזירה את הערך true אם אין תווים בטווח הזה, ומחזירה את הערך false . |
replaceAllText(findText, replaceText) | Integer | מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'. |
replaceAllText(findText, replaceText, matchCase) | Integer | מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'. |
select() | void | המערכת בוחרת רק את TextRange מהמצגת הפעילה, ומסירה את כל הבחירות הקודמות. |
setText(newText) | TextRange | מגדיר את הטקסט שתחום על ידי הטווח של הצורה או התא המשויכים של הטבלה. |
תיעוד מפורט
appendParagraph(text)
מצרפת פסקה בסוף טווח הטקסט. הפסקה שומרת על הסגנון של סוף טווח הטקסט הנוכחי.
מחרוזת הטקסט הנתונה מצורפת כפסקה על ידי הוספת תו אחד לפחות בשורה החדשה למחרוזת.
כאשר מחרוזת הטקסט שסופקה מכילה תווי שורה חדשה (וכך מורכבת מכמה פסקאות), מוחזרת הפסקה האחרונה שנוספה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | המחרוזת שיש לצרף כפסקה. |
החזרות
Paragraph
- הקובץ המצורף Paragraph
.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange)
צירוף עותק של טווח הטקסט שצוין לסוף טווח הטקסט הנוכחי.
העיצוב של הטקסט שיוכנס יתאים לעיצוב של טקסט המקור.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
textRange | TextRange | טווח הטקסט שיש לצרף. |
החזרות
TextRange
– טווח הטקסט שמייצג את הטקסט המצורף
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange, matchSourceFormatting)
צירוף עותק של טווח הטקסט שצוין לסוף טווח הטקסט הנוכחי.
אם המדיניות מוגדרת להתאים לעיצוב של טקסט היעד, הערכים AutoText
בטווח הטקסט שצוין מוחלפים בערכים המעובדם. בנוסף, רכיבים שאינם טקסט בטווח הטקסט שצוין לא יצורפו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
textRange | TextRange | טווח הטקסט שיש לצרף. |
matchSourceFormatting | Boolean | אם הערך הוא true , יש להתאים לעיצוב של טקסט המקור. אם
false , יש להתאים לעיצוב של טקסט היעד. |
החזרות
TextRange
– טווח הטקסט שמייצג את הטקסט המצורף
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendText(text)
מצרפת טקסט בסוף טווח הטקסט. הטקסט שומר על הסגנון של סוף הטקסט הקיים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | המחרוזת שיש לצרף. |
החזרות
TextRange
- טווח הטקסט שמייצג את הטקסט המצורף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asRenderedString()
מחזירה את הטקסט המעובד שתחום על ידי הטווח של הצורה המשויכת או תא הטבלה, בפורמט המתאים להצגה למשתמשי קצה.
רכיבי AutoText, כמו מספרי שקפים שנוצרים, מוחלפים בערכים המעובדים. המערכת תשמיט את כל הרכיבים שאינם טקסט בטווח.
החזרות
String
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asString()
מחזירה את הטקסט הגולמי שתחום על ידי הטווח של הצורה או תא הטבלה המשויכים.
רכיבי AutoText, כמו מספרי שקפים שנוצרו ורכיבים שאינם טקסט, שבטווח, מוחלפים בתו Unicode U+E907.
החזרות
String
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
clear()
ניקוי הטקסט שתחום בטווח הזה.
מכיוון שכל הטקסט בצורה או בתא בטבלה חייב להסתיים בשורה חדשה, השורה החדשה הסופית לא תוסר.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
clear(startOffset, endOffset)
מנקה את הטקסט שתחום על ידי היסט ההתחלה והסיום שבטווח.
מכיוון שהטקסט חייב להסתיים בשורה חדשה, השורה החדשה הסופית בטקסט לא תוסר גם אם היא מכוסה בהיסטים הנתונים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו
לקביעת אינדקס ההתחלה הכולל של הטווח שיש לנקות. היסט ההתחלה חייב להיות
שווה ל-0 או גדול מ-0, וקטן מ-endOffset או שווה לו. בנוסף, הערך startOffset חייב להיות קצר מאורך הטווח הנוכחי. |
endOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו
לקביעת אינדקס הסיום הבלעדי של הטווח שיש לנקות. הערך endOffset חייב להיות
שווה לערך startOffset או גדול ממנו. בנוסף, הערך endOffset חייב להיות קטן או שווה לאורך הטווח הנוכחי. |
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern)
מחזירה את כל הטווחים התואמים לדפוס החיפוש בטווח הטקסט הנוכחי. החיפוש הוא תלוי אותיות רישיות.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
pattern | String | הדפוס של הביטוי הרגולרי לחיפוש. יש לסמן כל לוכסן הפוך בתבנית. |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern, startOffset)
מחזירה את כל הטווחים שתואמים לדפוס החיפוש בטווח הטקסט הנוכחי, החל מהיסט ההתחלה. החיפוש הוא תלוי אותיות רישיות.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
pattern | String | הדפוס של הביטוי הרגולרי לחיפוש. יש לסמן כל לוכסן הפוך בתבנית. |
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס ההתחלה הכולל של טווח החיפוש. בנוסף, הערך startOffset חייב להיות קצר מהאורך של הטווח הנוכחי. |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutoTexts()
מחזירה את הטקסטים האוטומטיים בתוך טווח הטקסט הנוכחי.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndIndex()
מחזירה את האינדקס הבלעדי, המבוסס על 0, עבור התו האחרון בטווח הזה. אם אינדקסי ההתחלה והסיום שווים, הטווח נחשב ריק.
החזרות
Integer
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLength()
מחזירה את מספר התווים בטווח.
החזרות
Integer
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLinks()
הפונקציה מחזירה אוסף של טווחי טקסט שתואמים לכל Link
בטווח הטקסט הנוכחי, או שחופפים לטווח הטקסט הנוכחי.
כל טווח שמוחזר יכול להתפרס על פני קישור אחד כשהוא נוצר. אם עורכים שינויים בטקסט, הקישור כבר לא מייצג קישור אחד בלבד.
ניתן לגשת לכל Link
בטווחים שהוחזרו דרך TextStyle.getLink()
.
// Accesses the first link on a TextRange object. var linkTextRange = textRange.getLinks()[0]; var textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' var link = textStyle.getLink(); // Link object
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListParagraphs()
מחזירה את הפסקאות ברשימות שחופפות לטווח הטקסט הנוכחי.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListStyle()
getParagraphStyle()
מחזירה את ParagraphStyle
של טווח הטקסט הנוכחי.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParagraphs()
מחזירה את הפסקאות שחופפות לטווח הטקסט הנוכחי.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRange(startOffset, endOffset)
מחזירה TextRange
חדש שמכסה חלק מהטווח שממנו הוא נגזר.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס ההתחלה הכולל של הטווח המוחזר. היסט ההתחלה חייב להיות
שווה ל-0 או גדול מ-0, וקטן מ-endOffset או שווה לו. בנוסף, הערך startOffset חייב להיות קצר מאורך הטווח הנוכחי. |
endOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס הסיום הבלעדי של הטווח המוחזר. הערך endOffset חייב להיות
שווה לערך startOffset או גדול ממנו. בנוסף, הערך endOffset חייב להיות קטן או שווה לאורך הטווח הנוכחי. |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRuns()
מחזירה את רצפי הטקסט שחופפת לטווח הטקסט הנוכחי. הרצת טקסט היא קטע טקסט שבו לכל התווים יש אותו סגנון טקסט.
כל טווח שמוחזר יכול להתפרס על הפעלה אחת בלבד לאחר יצירתו. אם הטקסט ישתנה או סתם, יכול להיות שהוא לא ייצג יותר מפעולה אחת.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartIndex()
מחזירה את האינדקס הכולל, המבוסס על 0, עבור התו הראשון בטווח הזה. אם אינדקסי ההתחלה והסיום שווים, הטווח נחשב ריק.
החזרות
Integer
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTextStyle()
insertParagraph(startOffset, text)
הוספת פסקה בקיזוז ההתחלה. הפסקה שומרת על הסגנון של טווח הטקסט הנוכחי בהיסט ההתחלה.
מחרוזת הטקסט הנתונה מתווספת כפסקה על ידי הוספת תו אחד לפחות של השורה החדשה למחרוזת.
כאשר מחרוזת הטקסט שסופקה מכילה תווי שורה חדשה (וכך מורכבת מכמה פסקאות), מוחזרת הפסקה האחרונה שנוספה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס ההתחלה הכולל של הטקסט שיש להוסיף. |
text | String | המחרוזת שיש להוסיף. |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange)
הוספת עותק של טווח הטקסט שצוין בקיזוז ההתחלה.
העיצוב של הטקסט שיוכנס יתאים לעיצוב של טקסט המקור.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס ההתחלה הכולל של הטקסט שיש להוסיף. |
textRange | TextRange | טווח הטקסט שיש להוסיף. |
החזרות
TextRange
– טווח הטקסט שמייצג את הטקסט שהוזן
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange, matchSourceFormatting)
הוספת עותק של טווח הטקסט שצוין בקיזוז ההתחלה.
אם המדיניות מוגדרת להתאים לעיצוב של טקסט היעד, הערכים AutoText
בטווח הטקסט שצוין מוחלפים בערכים המעובדם. בנוסף, רכיבים שאינם טקסט בתוך טווח הטקסט שצוין לא יוכנסו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס ההתחלה הכולל של הטקסט שיש להוסיף. |
textRange | TextRange | טווח הטקסט שיש להוסיף. |
matchSourceFormatting | Boolean | אם הערך הוא true , יש להתאים לעיצוב של טקסט המקור. אם
false , יש להתאים לעיצוב של טקסט היעד. |
החזרות
TextRange
– טווח הטקסט שמייצג את הטקסט שהוזן
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertText(startOffset, text)
הוספת טקסט בקיזוז ההתחלה. הטקסט שומר על העיצוב של הטקסט הקיים בקיזוז ההתחלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
startOffset | Integer | מספר התווים מעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, ששימשו לקביעת אינדקס ההתחלה הכולל של הטקסט שיש להוסיף. |
text | String | המחרוזת שיש להוסיף. |
החזרות
TextRange
- טווח הטקסט שמייצג את הטקסט שהוזן.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isEmpty()
הפונקציה מחזירה את הערך true
אם אין תווים בטווח הזה, ומחזירה את הערך false
.
החזרות
Boolean
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'. החיפוש לא תלוי רישיות.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
findText | String | הטקסט שיש לחפש. |
replaceText | String | הטקסט שיחליף את הטקסט התואם. |
החזרות
Integer
– מספר המופעים השתנה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
findText | String | הטקסט שיש לחפש. |
replaceText | String | הטקסט שיחליף את הטקסט התואם. |
matchCase | Boolean | אם true , החיפוש הוא תלוי אותיות רישיות; אם false , החיפוש
לא תלוי אותיות רישיות. |
החזרות
Integer
– מספר המופעים השתנה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
המערכת בוחרת רק את TextRange
מהמצגת הפעילה, ומסירה את כל הבחירות הקודמות.
סקריפט יכול לגשת רק לבחירת המשתמש שמפעיל את הסקריפט, ורק אם הסקריפט מקושר למצגת.
ההורה Page
של ה-Shape
או ה-TableCell
המתאימים מוגדר
כ-current page selection
. הערך Shape
או TableCell
מוגדר בתור selected page element
.
Selection
:
- 1. טווח של טקסט, יש להשתמש ב-בחירה ב-TextRange שאינו ריק כדי לבחור את הטווח של התווים.
- 2. מיקום הסמן, יש להשתמש ב-TextRange ריק כדי למקם את הסמן באינדקס הרצוי.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText("Hello"); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
-
setText(newText)
מגדיר את הטקסט שתחום על ידי הטווח של הצורה או התא המשויכים של הטבלה. הטקסט שומר על הסגנון של תחילת הטקסט הקיים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
newText | String | המחרוזת שיש להגדיר כטקסט החדש. |
החזרות
TextRange
– טווח הטקסט שמייצג את הטקסט שהוגדר
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations