البحث عن نص أو استبداله داخل نطاق أو ورقة أو جدول بيانات ويمكن تحديد خيارات البحث أيضًا.
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
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 | الوصف |
|---|---|---|
ignoreDiacritics | Boolean | ما إذا كان البحث يراعي علامات التشكيل أم لا. |
استرجاع الكرة
TextFinder - أداة البحث عن النصوص هذه للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
إذا كان true، سيضبط عملية البحث لمطابقة حالة نص البحث تمامًا، وإلا سيتم ضبط البحث تلقائيًا على مطابقة غير حساسة لحالة الأحرف.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
matchCase | Boolean | ما إذا كانت المطابقة حسّاسة لحالة الأحرف. |
استرجاع الكرة
TextFinder - أداة البحث عن النصوص هذه للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
إذا تم استخدام true، سيتم ضبط البحث لمطابقة محتوى الخلية بالكامل، وإلا سيتم ضبط إعدادات البحث تلقائيًا على المطابقة الجزئية.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
matchEntireCell | Boolean | ما إذا كانت الخلية بأكملها مطابقة. |
استرجاع الكرة
TextFinder - أداة البحث عن النصوص هذه للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
إذا كان true، يضبط البحث لعرض التطابقات التي تظهر داخل نص الصيغة،
وإلا يتم اعتبار الخلايا التي تحتوي على صيغ بناءً على قيمتها المعروضة.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
matchFormulaText | Boolean | ما إذا كان البحث يفحص نص الصيغة أم لا. |
استرجاع الكرة
TextFinder - أداة البحث عن النصوص هذه للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
لاستبدال جميع التطابقات بالنص المحدد. تعرض عدد مرات الورود التي تم استبدالها، والذي قد يختلف عن عدد الخلايا المطابقة.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
replaceText | String | النص الذي يستبدل النص في الخلايا المطابقة. |
استرجاع الكرة
Integer — عدد مواضع الورود التي تم استبدالها.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
لاستبدال نص البحث في الخلية المطابقة حاليًا بالنص المحدد وعرض عدد مرات الورود التي تم استبدالها.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
replaceText | String | النص الذي يحل محل المحتوى في الخلية المطابقة حاليًا. |
استرجاع الكرة
Integer — عدد مواضع الورود التي تم استبدالها.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
تضبط هذه السياسة البحث لبدء البحث بعد نطاق الخلايا المحدد مباشرةً.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
startRange | Range | نطاق الخلايا الذي يجب أن يبدأ البحث بعده. |
استرجاع الكرة
TextFinder - أداة البحث عن النصوص هذه للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
إذا كان true، يضبط البحث لتفسير سلسلة البحث كتعبير عادي، وإلا يفسّر البحث سلسلة البحث على أنها نص عادي. لمزيد من التفاصيل حول كيفية
استخدام التعبيرات العادية، يمكنك الرجوع إلى
صفحة "البحث عن الدعم واستبداله".
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
useRegEx | Boolean | لتحديد ما إذا كان يلزم تفسير سلسلة البحث كتعبير عادي. |
استرجاع الكرة
TextFinder - أداة البحث عن النصوص هذه للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets