Поиск или замена текста в пределах диапазона, листа или электронной таблицы. Можно также указать параметры поиска.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
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