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	ما إذا كانت المطابقة حسّاسة لحالة الأحرف

الإرجاع

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