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

Class TextRange

קטע של תוכן הטקסט ב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 או גדול ממנו וקטן מ-`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.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var 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)`

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

פרמטרים

שם	סוג	תיאור
`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