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