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، يتم ضبط البحث لتجاهل علامات الترقيم أثناء المطابقة، وإلا تتم مطابقة البحث مع علامات الترقيم. علامة التشكيل هي علامة، مثل علامة النبر أو علامة المدّ، والتي تشير عند كتابتها فوق الحرف أو تحته إلى اختلاف في طريقة لفظ الحرف نفسه عند عدم وضع علامة عليه أو وضع علامة مختلفة عليه.

المعلَمات

الاسمالنوعالوصف
ignoreDiacriticsBooleanما إذا كان البحث يراعي علامات الترقيم

الإرجاع

TextFinder - أداة البحث عن النصوص هذه، لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

matchCase(matchCase)

إذا كانت القيمة true، يتم ضبط البحث لمطابقة حالة نص البحث تمامًا، وإلا يتم ضبط البحث تلقائيًا على المطابقة غير الحسّاسة لحالة الأحرف.

المعلَمات

الاسمالنوعالوصف
matchCaseBooleanما إذا كانت المطابقة حسّاسة لحالة الأحرف

الإرجاع

TextFinder - أداة البحث عن النصوص هذه، لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

matchEntireCell(matchEntireCell)

إذا كانت القيمة true، يتم ضبط البحث لمطابقة محتوى الخلية بالكامل، وإلا، يتم ضبط البحث تلقائيًا على المطابقة الجزئية.

المعلَمات

الاسمالنوعالوصف
matchEntireCellBooleanما إذا كانت الخلية بأكملها مطابقة

الإرجاع

TextFinder - أداة البحث عن النصوص هذه، لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

matchFormulaText(matchFormulaText)

إذا كان true، يتم ضبط البحث لعرض المطابقات التي تظهر في نص الصيغة، وإلا، يتم اعتبار الخلايا التي تحتوي على صِيَغ استنادًا إلى قيمتها المعروضة.

المعلَمات

الاسمالنوعالوصف
matchFormulaTextBooleanما إذا كان البحث يفحص نص الصيغة

الإرجاع

TextFinder - أداة البحث عن النصوص هذه، لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

replaceAllWith(replaceText)

استبدال جميع المطابقات بالنص المحدّد تُرجِع عدد مرّات الاستبدال، والذي قد يختلف عن عدد الخلايا التي تمت مطابقتها.

المعلَمات

الاسمالنوعالوصف
replaceTextStringالنص الذي يستبدل النص في الخلايا المطابقة.

الإرجاع

Integer: عدد مرات التكرار التي تم استبدالها

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

replaceWith(replaceText)

تستبدل هذه الدالة نص البحث في الخلية التي تمت المطابقة معها حاليًا بالنص المحدّد، وتُعرِض عدد مواضع الاستبدال.

المعلَمات

الاسمالنوعالوصف
replaceTextStringالنص الذي يستبدل المحتوى في الخلية التي تمت مطابقتها حاليًا

الإرجاع

Integer: عدد مرات التكرار التي تم استبدالها

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

startFrom(startRange)

لضبط البحث لبدء البحث مباشرةً بعد نطاق الخلايا المحدّد.

المعلَمات

الاسمالنوعالوصف
startRangeRangeنطاق الخلايا الذي يجب أن يبدأ البحث بعده.

الإرجاع

TextFinder - أداة البحث عن النصوص هذه، لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

useRegularExpression(useRegEx)

إذا كان true، يتم ضبط البحث لتفسير سلسلة البحث على أنّها تعبير عادي، وإلا يفسّر البحث سلسلة البحث على أنّها نص عادي. لمزيد من التفاصيل حول كيفية استخدام التعبيرات العادية، يُرجى الرجوع إلى صفحة الدعم المتعلّقة بميزة "البحث والاستبدال".

المعلَمات

الاسمالنوعالوصف
useRegExBooleanما إذا كان سيتم تفسير سلسلة البحث على أنّها تعبير عادي

الإرجاع

TextFinder - أداة البحث عن النصوص هذه، لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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