Class TextRange

TextRange

מקטע של תוכן הטקסט של Shape או TableCell.

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
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()

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

רכיבי טקסט אוטומטי, כמו מספרי שקפים שנוצרו וכל רכיב שאינו טקסט בטווח, מוחלפים בתו Unicode‏ U+E907.

חזרה

String

אישור

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

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

---

clear()

ניקוי הטקסט שמוגדר בטווח הזה.

מכיוון שכל הטקסט ב-Shape או ב-TableCell חייב להסתיים בשורה חדשה, השורה החדשה האחרונה בטקסט לא תוסר.

אישור

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

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

---

clear(startOffset, endOffset)

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

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

פרמטרים

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

חזרה

TextRange[]

אישור

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

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

---

find(pattern, startOffset)

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

פרמטרים

שם	סוג	תיאור
pattern	String	דפוס הביטוי הרגולרי לחיפוש. צריך להשתמש בתו בריחה (escape) לפני קווים נטויים שמאליים בדפוס.
startOffset	Integer	מספר התווים שמעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, המשמש לקביעת אינדקס ההתחלה הכולל של הטווח לחיפוש. הערך של startOffset חייב להיות קטן גם מאורך הטווח הנוכחי.

חזרה

TextRange[]

אישור

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

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

---

getAutoTexts()

הפונקציה מחזירה את הטקסטים האוטומטיים בטווח הטקסט הנוכחי.

חזרה

AutoText[]

אישור

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

• 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.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
const linkTextRange = textRange.getLinks()[0];
const textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink());   // logs 'true'
const link = textStyle.getLink();  // Link object

חזרה

TextRange[]

אישור

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

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

---

getListParagraphs()

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

חזרה

Paragraph[]

אישור

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

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

---

getListStyle()

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

חזרה

ListStyle

אישור

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

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

---

getParagraphStyle()

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

חזרה

ParagraphStyle

אישור

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

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

---

getParagraphs()

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

חזרה

Paragraph[]

אישור

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

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

---

getRange(startOffset, endOffset)

הפונקציה מחזירה TextRange חדש שכולל חלק מהטווח שממנו הוא נגזר.

פרמטרים

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

חזרה

TextRange

אישור

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

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

---

getRuns()

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

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

חזרה

TextRange[]

אישור

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

• 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()

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

חזרה

TextStyle

אישור

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

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

---

insertParagraph(startOffset, text)

הוספת פיסקה בהיסט ההתחלה. הפסקה שומרת על העיצוב של טווח הטקסט הנוכחי בהיסט ההתחלה.

כדי להוסיף את מחרוזת הטקסט כפסקה, צריך להוסיף למחרוזת לפחות תו אחד של שורת חדשה.

כשמחרוזת הטקסט שסופקה מכילה תווים של שורה חדשה (כלומר מורכבת מכמה פיסקאות), הפונקציה מחזירה את הפסקה האחרונה שנוספה.

פרמטרים

שם	סוג	תיאור
startOffset	Integer	מספר התווים שמעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, המשמשים לקביעת אינדקס ההתחלה הכולל של הטקסט שרוצים להוסיף.
text	String	המחרוזת שרוצים להוסיף.

חזרה

Paragraph – ה-Paragraph שהוכנס.

אישור

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

• 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)

הוספת טקסט בהיסט ההתחלה. הטקסט שנוסף יהיה באותו עיצוב של הטקסט הקיים ב-offset ההתחלתי.

פרמטרים

שם	סוג	תיאור
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. טווח טקסט, משתמשים ב-select ב-TextRange לא ריק כדי לבחור את הטווח של התווים.
• 2. מיקום הסמן, משתמשים ב-TextRange ריק כדי למקם את הסמן במדד הרצוי.

  const 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