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

مستندات دقیق

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

پارامترها

نام نوع توضیحات
ignore Diacritics Boolean اینکه آیا جستجو علائم تفکیکی را در نظر می‌گیرد یا خیر.

بازگشت

TextFinder — این یابنده متن، برای زنجیره‌سازی.

مجوز

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

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

matchCase(matchCase)

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

پارامترها

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

بازگشت

TextFinder — این یابنده متن، برای زنجیره‌سازی.

مجوز

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

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

matchEntireCell(matchEntireCell)

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

پارامترها

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

بازگشت

TextFinder — این یابنده متن، برای زنجیره‌سازی.

مجوز

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

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

matchFormulaText(matchFormulaText)

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

پارامترها

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

بازگشت

TextFinder — این یابنده متن، برای زنجیره‌سازی.

مجوز

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

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

replaceAllWith(replaceText)

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

پارامترها

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

بازگشت

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

مجوز

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

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

replaceWith(replaceText)

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

پارامترها

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

بازگشت

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

مجوز

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

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

startFrom(startRange)

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

پارامترها

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

بازگشت

TextFinder — این یابنده متن، برای زنجیره‌سازی.

مجوز

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

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

useRegularExpression(useRegEx)

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

پارامترها

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

بازگشت

TextFinder — این یابنده متن، برای زنجیره‌سازی.

مجوز

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

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