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

פרמטרים

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

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

---

matchCase(matchCase)

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

פרמטרים

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

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

---

matchEntireCell(matchEntireCell)

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

פרמטרים

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

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

---

matchFormulaText(matchFormulaText)

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

פרמטרים

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

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

---

replaceAllWith(replaceText)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

replaceWith(replaceText)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

startFrom(startRange)

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

פרמטרים

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

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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

---

useRegularExpression(useRegEx)

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

פרמטרים

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

חזרה

TextFinder — This text finder, for chaining.

אישור

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

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