Class TextFinder

TextFinder

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
findAll()	Range[]	הפונקציה מחזירה את כל התאים שתואמים לקריטריונים לחיפוש.
findNext()	Range	הפונקציה מחזירה את התא הבא שתואם לקריטריונים לחיפוש.
findPrevious()	Range	הפונקציה מחזירה את התא הקודם שתואם לקריטריונים לחיפוש.
getCurrentMatch()	Range	הפונקציה מחזירה את התא הנוכחי שתואם לקריטריונים לחיפוש.
ignoreDiacritics(ignoreDiacritics)	TextFinder	אם הערך הוא true, החיפוש מתעלם מהסימנים ה diacritic במהלך ההתאמה. אחרת, החיפוש מתאים לסימנים ה diacritic.
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, החיפוש מתעלם מהסימנים ה diacritic במהלך ההתאמה. אחרת, החיפוש מתאים לסימנים ה diacritic. סימן דיאקריטי הוא סימן, כמו סימן הטעמה או סימן קדימה (cezille), שכתוב מעל או מתחת לאות ומציין הבדל בהגייה של אותה אות כשהיא לא מסומנת או מסומנת באופן שונה.

פרמטרים

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

חזרה

TextFinder – הכלי הזה לאיתור טקסט, לצורך קישור.

אישור

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

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

---

matchCase(matchCase)

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

פרמטרים

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

חזרה

TextFinder — הכלי הזה לאיתור טקסט, לצורך שרשור.

אישור

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

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

---

matchEntireCell(matchEntireCell)

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

פרמטרים

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

חזרה

TextFinder – הכלי הזה לאיתור טקסט, לצורך קישור.

אישור

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

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

---

matchFormulaText(matchFormulaText)

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

פרמטרים

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

חזרה

TextFinder — הכלי הזה לאיתור טקסט, לצורך קישור.

אישור

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

• 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 — הכלי הזה לאיתור טקסט, לצורך קישור.

אישור

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

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

---

useRegularExpression(useRegEx)

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

פרמטרים

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

חזרה

TextFinder – הכלי הזה לאיתור טקסט, לצורך שרשור.

אישור

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

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