דף זה תורגם על ידי Cloud Translation API.

Class 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