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 , поиск настраивает игнорирование диакритических знаков при сопоставлении; в противном случае поиск соответствует диакритическим знакам. Диакритический знак — это знак, такой как ударение или седиль, который, написанный над или под буквой, указывает на разницу в произношении с той же буквой, когда она не отмечена или отмечена по-другому.

Параметры

Имя Тип Описание
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