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

المَعلمات

الاسمTypeالوصف
ignoreDiacriticsBooleanما إذا كان البحث يراعي علامات التشكيل أم لا.

استرجاع الكرة

TextFinder - أداة البحث عن النصوص هذه للتسلسل.

التفويض

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

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

matchCase(matchCase)

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

المَعلمات

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

استرجاع الكرة

TextFinder - أداة البحث عن النصوص هذه للتسلسل.

التفويض

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

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

matchEntireCell(matchEntireCell)

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

المَعلمات

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

استرجاع الكرة

TextFinder - أداة البحث عن النصوص هذه للتسلسل.

التفويض

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

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

matchFormulaText(matchFormulaText)

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

المَعلمات

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

استرجاع الكرة

TextFinder - أداة البحث عن النصوص هذه للتسلسل.

التفويض

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

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

replaceAllWith(replaceText)

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

المَعلمات

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

استرجاع الكرة

Integer — عدد مواضع الورود التي تم استبدالها.

التفويض

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

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

replaceWith(replaceText)

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

المَعلمات

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

استرجاع الكرة

Integer — عدد مواضع الورود التي تم استبدالها.

التفويض

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

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

startFrom(startRange)

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

المَعلمات

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

استرجاع الكرة

TextFinder - أداة البحث عن النصوص هذه للتسلسل.

التفويض

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

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

useRegularExpression(useRegEx)

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

المَعلمات

الاسمTypeالوصف
useRegExBooleanلتحديد ما إذا كان يلزم تفسير سلسلة البحث كتعبير عادي.

استرجاع الكرة

TextFinder - أداة البحث عن النصوص هذه للتسلسل.

التفويض

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

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