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

Параметры

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