Class TextFinder

TextFinder

חיפוש או החלפה של טקסט בטווח, בגיליון או בגיליון אלקטרוני. אפשר גם לציין אפשרויות חיפוש.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
findAll()Range[]הפונקציה מחזירה את כל התאים שתואמים לקריטריוני החיפוש.
findNext()Rangeהפונקציה מחזירה את התא הבא שתואם לקריטריונים לחיפוש.
findPrevious()Rangeהפונקציה מחזירה את התא הקודם שתואם לקריטריונים של החיפוש.
getCurrentMatch()Rangeהפונקציה מחזירה את התא הנוכחי שתואם לקריטריונים לחיפוש.
ignoreDiacritics(ignoreDiacritics)TextFinderאם true, החיפוש מוגדר להתעלם מסימנים דיאקריטיים בזמן ההתאמה. אחרת, החיפוש מתאים לסימנים דיאקריטיים.
matchCase(matchCase)TextFinderאם ההגדרה true מופעלת, החיפוש מוגדר כך שיהיה תלוי אותיות רישיות, אחרת החיפוש מוגדר כברירת מחדל כך שלא יהיה תלוי אותיות רישיות.
matchEntireCell(matchEntireCell)TextFinderאם true, החיפוש מוגדר להתאמה לכל התוכן בתא. אחרת, החיפוש מוגדר כברירת מחדל להתאמה חלקית.
matchFormulaText(matchFormulaText)TextFinderאם true, החיפוש מוגדר להחזרת התאמות שמופיעות בטקסט של הנוסחה; אחרת, תאים עם נוסחאות נחשבים על סמך הערך המוצג שלהם.
replaceAllWith(replaceText)Integerהחלפת כל ההתאמות בטקסט שצוין.
replaceWith(replaceText)Integerמחליפה את הטקסט לחיפוש בתא הנוכחי שתואם לטקסט שצוין, ומחזירה את מספר המקרים שהוחלפו.
startFrom(startRange)TextFinderמגדיר את החיפוש כך שיתחיל לחפש מיד אחרי טווח התאים שצוין.
useRegularExpression(useRegEx)TextFinderאם true, החיפוש מוגדר לפרש את מחרוזת החיפוש כביטוי רגולרי; אחרת, החיפוש מפרש את מחרוזת החיפוש כטקסט רגיל.

תיעוד מפורט

findAll()

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

חזרה

‫Range[] – כל התאים התואמים.

אישור

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

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

findNext()

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

חזרה

‫Range — התא התואם הבא, או null אם אין התאמות קודמות.

אישור

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

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

findPrevious()

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

חזרה

‫Range – התא התואם הקודם, או null אם אין התאמות קודמות.

אישור

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

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

getCurrentMatch()

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

חזרה

‫Range – התא הנוכחי התואם, או null אם אין התאמות נוספות.

אישור

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

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

ignoreDiacritics(ignoreDiacritics)

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

פרמטרים

שםסוגתיאור
ignoreDiacriticsBooleanאם החיפוש מתייחס לסימנים דיאקריטיים.

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

matchCase(matchCase)

אם ההגדרה true מופעלת, החיפוש מוגדר כך שיהיה תלוי אותיות רישיות, אחרת החיפוש מוגדר כברירת מחדל כך שלא יהיה תלוי אותיות רישיות.

פרמטרים

שםסוגתיאור
matchCaseBooleanהאם ההתאמה היא תלוית אותיות רישיות.

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

matchEntireCell(matchEntireCell)

אם true, החיפוש מוגדר להתאמה לכל התוכן בתא. אחרת, החיפוש מוגדר כברירת מחדל להתאמה חלקית.

פרמטרים

שםסוגתיאור
matchEntireCellBooleanאם כל התא תואם.

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

matchFormulaText(matchFormulaText)

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

פרמטרים

שםסוגתיאור
matchFormulaTextBooleanהאם החיפוש בודק טקסט של נוסחה.

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

replaceAllWith(replaceText)

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

פרמטרים

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

חזרה

‫Integer — מספר המקרים שהוחלפו.

אישור

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

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

replaceWith(replaceText)

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

פרמטרים

שםסוגתיאור
replaceTextStringהטקסט שמחליף את התוכן בתא שמתאים כרגע.

חזרה

‫Integer — מספר המקרים שהוחלפו.

אישור

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

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

startFrom(startRange)

מגדיר את החיפוש כך שיתחיל לחפש מיד אחרי טווח התאים שצוין.

פרמטרים

שםסוגתיאור
startRangeRangeטווח התאים שאחריו צריך להתחיל החיפוש.

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

useRegularExpression(useRegEx)

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

פרמטרים

שםסוגתיאור
useRegExBooleanהאם לפרש את מחרוזת החיפוש כביטוי רגולרי.

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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