Class TextFinder

متن یاب

متن را در محدوده، صفحه یا صفحه گسترده پیدا یا جایگزین کنید. همچنین می توانید گزینه های جستجو را مشخص کنید.

روش ها

روش نوع برگشت شرح مختصر
find All() Range[] تمام سلول های مطابق با معیارهای جستجو را برمی گرداند.
find Next() Range سلول بعدی مطابق با معیارهای جستجو را برمی‌گرداند.
find Previous() Range سلول قبلی مطابق با معیارهای جستجو را برمی‌گرداند.
get Current Match() Range سلول فعلی مطابق با معیارهای جستجو را برمی‌گرداند.
ignore Diacritics(ignoreDiacritics) Text Finder اگر true ، جستجو را طوری پیکربندی می‌کند که هنگام تطبیق، نشانه‌ها را نادیده بگیرد. در غیر این صورت جستجو با نشانه ها مطابقت دارد.
match Case(matchCase) Text Finder اگر true ، جستجو را طوری پیکربندی می‌کند که دقیقاً با حروف بزرگ متن جستجو مطابقت داشته باشد، در غیر این صورت جستجو به‌طور پیش‌فرض روی تطبیق غیرحساس به حروف بزرگ است.
match Entire Cell(matchEntireCell) Text Finder اگر true ، جستجو را طوری پیکربندی می‌کند که با کل محتوای یک سلول مطابقت داشته باشد. در غیر این صورت، جستجو به طور پیش فرض به تطابق جزئی است.
match Formula Text(matchFormulaText) Text Finder اگر true ، جستجو را طوری پیکربندی می‌کند که منطبقاتی را که در متن فرمول ظاهر می‌شوند برگرداند. در غیر این صورت سلول های دارای فرمول بر اساس مقدار نمایش داده شده در نظر گرفته می شوند.
replace All With(replaceText) Integer همه موارد منطبق را با متن مشخص شده جایگزین می کند.
replace With(replaceText) Integer متن جستجو را در سلولی که در حال حاضر مطابقت دارد با متن مشخص شده جایگزین می کند و تعداد تکرارهای جایگزین شده را برمی گرداند.
start From(startRange) Text Finder جستجو را به گونه ای پیکربندی می کند که بلافاصله پس از محدوده سلولی مشخص شده، جستجو آغاز شود.
use Regular Expression(useRegEx) Text Finder اگر true ، جستجو را برای تفسیر رشته جستجو به عنوان یک عبارت منظم پیکربندی می کند. در غیر این صورت جستجو رشته جستجو را به عنوان متن عادی تفسیر می کند.

مستندات دقیق

find All()

تمام سلول های مطابق با معیارهای جستجو را برمی گرداند.

بازگشت

Range[] - همه سلول های منطبق.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

find Next()

سلول بعدی مطابق با معیارهای جستجو را برمی‌گرداند.

بازگشت

Range - سلول منطبق بعدی، یا اگر هیچ منطبق قبلی وجود نداشته باشد null .

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

find Previous()

سلول قبلی مطابق با معیارهای جستجو را برمی‌گرداند.

بازگشت

Range - سلول منطبق قبلی، یا اگر هیچ منطبق قبلی وجود نداشته باشد null .

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Current Match()

سلول فعلی مطابق با معیارهای جستجو را برمی‌گرداند.

بازگشت

Range - سلول تطبیق فعلی، یا اگر هیچ منطبق دیگری وجود نداشته باشد null .

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

ignore Diacritics(ignoreDiacritics)

اگر true ، جستجو را طوری پیکربندی می‌کند که هنگام تطبیق، نشانه‌ها را نادیده بگیرد. در غیر این صورت جستجو با نشانه ها مطابقت دارد. دیاکریتیک نشانه ای است، مانند لهجه یا cedilla، که وقتی در بالا یا پایین یک حرف نوشته شود، نشان دهنده تفاوت تلفظ با همان حرف است، وقتی علامت گذاری نشده باشد یا با علامت متفاوت مشخص شود.

پارامترها

نام تایپ کنید توضیحات
ignore Diacritics Boolean این که آیا جستجو نشانه‌هایی را در نظر می‌گیرد.

بازگشت

Text Finder - این متن یاب، برای زنجیر کردن.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

match Case(matchCase)

اگر true ، جستجو را طوری پیکربندی می‌کند که دقیقاً با حروف بزرگ متن جستجو مطابقت داشته باشد، در غیر این صورت جستجو به‌طور پیش‌فرض روی تطبیق غیرحساس به حروف بزرگ است.

پارامترها

نام تایپ کنید توضیحات
match Case Boolean آیا تطبیق به حروف بزرگ و کوچک حساس است یا خیر.

بازگشت

Text Finder - این متن یاب، برای زنجیر کردن.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

match Entire Cell(matchEntireCell)

اگر true ، جستجو را طوری پیکربندی می‌کند که با کل محتوای یک سلول مطابقت داشته باشد. در غیر این صورت، جستجو به طور پیش فرض به تطابق جزئی است.

پارامترها

نام تایپ کنید توضیحات
match Entire Cell Boolean اینکه آیا کل سلول مطابقت دارد یا خیر.

بازگشت

Text Finder - این متن یاب، برای زنجیر کردن.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

match Formula Text(matchFormulaText)

اگر true ، جستجو را طوری پیکربندی می‌کند که منطبقاتی را که در متن فرمول ظاهر می‌شوند برگرداند. در غیر این صورت سلول های دارای فرمول بر اساس مقدار نمایش داده شده در نظر گرفته می شوند.

پارامترها

نام تایپ کنید توضیحات
match Formula Text Boolean آیا جستجو متن فرمول را بررسی می کند یا خیر.

بازگشت

Text Finder - این متن یاب، برای زنجیر کردن.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

replace All With(replaceText)

همه موارد منطبق را با متن مشخص شده جایگزین می کند. تعداد تکرارهای جایگزین شده را برمی‌گرداند که ممکن است با تعداد سلول‌های منطبق متفاوت باشد.

پارامترها

نام تایپ کنید توضیحات
replace Text String متنی که جایگزین متن در سلول های منطبق می شود.

بازگشت

Integer - تعداد موارد جایگزین شده.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

replace With(replaceText)

متن جستجو را در سلولی که در حال حاضر مطابقت دارد با متن مشخص شده جایگزین می کند و تعداد تکرارهای جایگزین شده را برمی گرداند.

پارامترها

نام تایپ کنید توضیحات
replace Text String متنی که جایگزین محتوای موجود در سلول منطبق می شود.

بازگشت

Integer - تعداد موارد جایگزین شده.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

start From(startRange)

جستجو را به گونه ای پیکربندی می کند که بلافاصله پس از محدوده سلولی مشخص شده، جستجو آغاز شود.

پارامترها

نام تایپ کنید توضیحات
start Range Range محدوده سلولی که پس از آن جستجو باید شروع شود.

بازگشت

Text Finder - این متن یاب، برای زنجیر کردن.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

use Regular Expression(useRegEx)

اگر true ، جستجو را برای تفسیر رشته جستجو به عنوان یک عبارت منظم پیکربندی می کند. در غیر این صورت جستجو رشته جستجو را به عنوان متن عادی تفسیر می کند. برای جزئیات بیشتر در مورد نحوه استفاده از عبارات منظم، به صفحه پشتیبانی یافتن و جایگزینی مراجعه کنید.

پارامترها

نام تایپ کنید توضیحات
use Reg Ex Boolean آیا رشته جستجو را به عنوان یک عبارت منظم تفسیر کنیم.

بازگشت

Text Finder - این متن یاب، برای زنجیر کردن.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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