דף זה תורגם על ידי 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 או גדול מ-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`	הדפוס של הביטוי הרגולרי לחיפוש. יש לסמן כל לוכסן הפוך בתבנית.

החזרות

TextRange[]

הרשאות

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

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

`find(pattern, startOffset)`

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

פרמטרים

שם	תיאור	התיאור
`pattern`	`String`	הדפוס של הביטוי הרגולרי לחיפוש. יש לסמן כל לוכסן הפוך בתבנית.
`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 או גדול מ-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