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הפונקציה מחזירה את האינדקס הבלעדי (exclusive) של התו האחרון בטווח הזה, כשהספירה מתחילה מ-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()

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

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

חזרה

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

חזרה

TextRange[] — רשימה של טווחי טקסט.

אישור

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

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

find(pattern, startOffset)

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

פרמטרים

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

הפונקציה מחזירה את האינדקס הבלעדי (exclusive) של התו האחרון בטווח הזה, כשהספירה מתחילה מ-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)

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

פרמטרים

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

חזרה

‫TextRange — טווח הטקסט שמייצג את הטקסט שהוכנס.

אישור

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

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

isEmpty()

הפונקציה מחזירה true אם אין תווים בטווח הזה, ומחזירה false בכל מקרה אחר.

חזרה

‫Boolean — true אם אין תווים בטווח הזה, ומחזירה false אחרת.

אישור

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

  • 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. טווח טקסט, משתמשים בבחירה ב-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