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)

הוספת פסקה בסוף טווח הטקסט. הסגנון של הפסקה נשמר לפי הסגנון של סוף טווח הטקסט הנוכחי.

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

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

פרמטרים

שםסוגתיאור
textStringהמחרוזת שרוצים לצרף כפסקה.

חזרה

Paragraph – ה-Paragraph שנוסף.

אישור

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

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

appendRange(textRange)

הוספת עותק של טווח הטקסט שצוין לסוף טווח הטקסט הנוכחי.

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

פרמטרים

שםסוגתיאור
textRangeTextRangeטווח הטקסט שרוצים לצרף.

חזרה

TextRange – טווח הטקסט שמייצג את הטקסט שנוסף

אישור

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

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

appendRange(textRange, matchSourceFormatting)

הוספת עותק של טווח הטקסט שצוין לסוף טווח הטקסט הנוכחי.

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

פרמטרים

שםסוגתיאור
textRangeTextRangeטווח הטקסט שרוצים לצרף.
matchSourceFormattingBooleanאם הערך הוא true, מתאימים את העיצוב לטקסט המקור. אם הערך הוא false, מתאימים את העיצוב לטקסט היעד.

חזרה

TextRange – טווח הטקסט שמייצג את הטקסט שנוסף

אישור

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

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

appendText(text)

הוספת טקסט בסוף טווח הטקסט. הטקסט שנוסף יהיה באותו סגנון כמו הטקסט הקיים בסוף.

פרמטרים

שםסוגתיאור
textStringהמחרוזת שרוצים לצרף.

חזרה

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)

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

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

פרמטרים

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

אישור

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

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

find(pattern)

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

פרמטרים

שםסוגתיאור
patternStringדפוס הביטוי הרגולרי לחיפוש. צריך להשתמש בתו בריחה (escape) לפני קווים נטויים שמאליים בדפוס.

חזרה

TextRange[]

אישור

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

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

find(pattern, startOffset)

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

פרמטרים

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

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

פרמטרים

שםסוגתיאור
startOffsetIntegerמספר התווים שמעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, המשמש לקביעת אינדקס ההתחלה הכולל של הטווח המוחזר. היסט ההתחלה חייב להיות שווה ל-0 או גדול ממנו, וקטן מ-endOffset או שווה לו. הערך של startOffset חייב להיות קטן גם מאורך הטווח הנוכחי.
endOffsetIntegerמספר התווים שמעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, המשמשים לקביעת אינדקס הסיום הבלעדי של הטווח המוחזר. הערך של 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)

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

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

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

פרמטרים

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

חזרה

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

אישור

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

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

insertRange(startOffset, textRange)

הוספה של עותק של טווח הטקסט שצוין בהיסט ההתחלה.

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

פרמטרים

שםסוגתיאור
startOffsetIntegerמספר התווים שמעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, המשמשים לקביעת אינדקס ההתחלה הכולל של הטקסט שרוצים להוסיף.
textRangeTextRangeטווח הטקסט שרוצים להוסיף.

חזרה

TextRange – טווח הטקסט שמייצג את הטקסט שנוסף

אישור

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

הוספה של עותק של טווח הטקסט שצוין בהיסט ההתחלה.

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

פרמטרים

שםסוגתיאור
startOffsetIntegerמספר התווים שמעבר לאינדקס ההתחלה של טווח הטקסט הנוכחי, המשמשים לקביעת אינדקס ההתחלה הכולל של הטקסט שרוצים להוסיף.
textRangeTextRangeטווח הטקסט שרוצים להוסיף.
matchSourceFormattingBooleanאם הערך הוא true, מתאימים את העיצוב לטקסט המקור. אם הערך הוא false, מתאימים את העיצוב לטקסט היעד.

חזרה

TextRange – טווח הטקסט שמייצג את הטקסט שנוסף

אישור

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

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

insertText(startOffset, text)

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

פרמטרים

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

חזרה

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)

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

פרמטרים

שםסוגתיאור
findTextStringהטקסט שרוצים למצוא.
replaceTextStringהטקסט שרוצים להחליף את הטקסט התואם.

חזרה

Integer – מספר החזרות השתנה

אישור

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

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

replaceAllText(findText, replaceText, matchCase)

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

פרמטרים

שםסוגתיאור
findTextStringהטקסט שרוצים למצוא.
replaceTextStringהטקסט שרוצים להחליף את הטקסט התואם.
matchCaseBooleanאם הערך הוא 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)

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

    פרמטרים

    שםסוגתיאור
    newTextStringהמחרוזת שתוגדר כטקסט החדש.

    חזרה

    TextRange – טווח הטקסט שמייצג את הטקסט שהוגדר

    אישור

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

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