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 ، جستجو را طوری پیکربندی می‌کند که هنگام تطبیق، نشانه‌ها را نادیده بگیرد. در غیر این صورت جستجو با نشانه ها مطابقت دارد. دیاکریتیک نشانه ای است، مانند لهجه یا cedilla، که وقتی در بالا یا پایین یک حرف نوشته شود، نشان دهنده تفاوت تلفظ با همان حرف است، وقتی علامت گذاری نشده باشد یا با علامت متفاوت مشخص شود.

مولفه های

نام تایپ کنید شرح
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