דף זה תורגם על ידי Cloud Translation API.

Class TextFinder

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

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`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 - מאתר הטקסט הזה, לשרשור.

הרשאות

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

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

`matchCase(matchCase)`

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

פרמטרים

שם	תיאור	התיאור
`matchCase`	`Boolean`	האם ההתאמה תלוית אותיות רישיות (case-sensitive).

החזרות

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