Class TextFinder

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