Znajdowanie lub zastępowanie tekstu w zakresie, arkuszu lub arkuszu kalkulacyjnym. Możesz też określić opcje wyszukiwania.
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
find | Range[] | Zwraca wszystkie komórki spełniające kryteria wyszukiwania. |
find | Range | Zwraca następną komórkę spełniającą kryteria wyszukiwania. |
find | Range | Zwraca poprzednią komórkę spełniającą kryteria wyszukiwania. |
get | Range | Zwraca bieżącą komórkę pasującą do kryteriów wyszukiwania. |
ignore | Text | Jeśli true, konfiguruje wyszukiwanie tak, aby podczas dopasowywania ignorowało znaki diakrytyczne; w przeciwnym razie wyszukiwanie dopasowuje znaki diakrytyczne. |
match | Text | Jeśli true, konfiguruje wyszukiwanie tak, aby dokładnie dopasowywać wielkość liter w tekście wyszukiwania. W przeciwnym razie wyszukiwanie domyślnie nie uwzględnia wielkości liter. |
match | Text | Jeśli true, konfiguruje wyszukiwanie tak, aby dopasowywać całą zawartość komórki; w przeciwnym razie wyszukiwanie domyślnie dopasowuje częściowo. |
match | Text | Jeśli true, konfiguruje wyszukiwanie tak, aby zwracało dopasowania występujące w tekście formuły; w przeciwnym razie komórki z formułami są uwzględniane na podstawie wyświetlanej wartości. |
replace | Integer | Zastępuje wszystkie dopasowania określonym tekstem. |
replace | Integer | Zastępuje tekst wyszukiwania w aktualnie dopasowanej komórce określonym tekstem i zwraca liczbę zastąpień. |
start | Text | Konfiguruje wyszukiwanie tak, aby rozpoczynało się natychmiast po określonym zakresie komórek. |
use | Text | Jeśli true, konfiguruje wyszukiwanie tak, aby ciąg wyszukiwania był interpretowany jako wyrażenie regularne. W przeciwnym razie ciąg wyszukiwania jest interpretowany jako zwykły tekst. |
Szczegółowa dokumentacja
findAll()
Zwraca wszystkie komórki spełniające kryteria wyszukiwania.
Powrót
Range[] – wszystkie pasujące komórki.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Zwraca następną komórkę spełniającą kryteria wyszukiwania.
Powrót
Range – następna pasująca komórka lub null, jeśli nie ma poprzednich dopasowań.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Zwraca poprzednią komórkę spełniającą kryteria wyszukiwania.
Powrót
Range – poprzednia pasująca komórka lub null, jeśli nie ma poprzednich dopasowań.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Zwraca bieżącą komórkę pasującą do kryteriów wyszukiwania.
Powrót
Range – bieżąca pasująca komórka lub null, jeśli nie ma więcej pasujących komórek.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
Jeśli true, konfiguruje wyszukiwanie tak, aby podczas dopasowywania ignorowało znaki diakrytyczne; w przeciwnym razie wyszukiwanie dopasowuje znaki diakrytyczne. Znak diakrytyczny to znak, np. akcent lub cedilla, który po napisaniu nad lub pod literą wskazuje różnicę w wymowie w porównaniu z tą samą literą bez znaku lub z innym znakiem.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
ignore | Boolean | Określa, czy wyszukiwanie uwzględnia znaki diakrytyczne. |
Powrót
TextFinder – ten wyszukiwacz tekstu do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
Jeśli true, konfiguruje wyszukiwanie tak, aby dokładnie dopasowywać wielkość liter w tekście wyszukiwania. W przeciwnym razie wyszukiwanie domyślnie nie uwzględnia wielkości liter.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
match | Boolean | Czy w dopasowaniu jest rozróżniana wielkość liter. |
Powrót
TextFinder – ten wyszukiwacz tekstu do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
Jeśli true, konfiguruje wyszukiwanie tak, aby dopasowywać całą zawartość komórki; w przeciwnym razie wyszukiwanie domyślnie dopasowuje częściowo.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
match | Boolean | Wskazuje, czy cała komórka jest dopasowana. |
Powrót
TextFinder – ten wyszukiwacz tekstu do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
Jeśli true, konfiguruje wyszukiwanie tak, aby zwracało dopasowania występujące w tekście formuły; w przeciwnym razie komórki z formułami są uwzględniane na podstawie wyświetlanej wartości.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
match | Boolean | Określa, czy wyszukiwanie obejmuje tekst formuły. |
Powrót
TextFinder – ten wyszukiwacz tekstu do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Zastępuje wszystkie dopasowania określonym tekstem. Zwraca liczbę zastąpionych wystąpień, która może się różnić od liczby dopasowanych komórek.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
replace | String | Tekst, który zastąpi tekst w komórkach spełniających kryteria. |
Powrót
Integer – liczba zastąpionych wystąpień.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Zastępuje tekst wyszukiwania w aktualnie dopasowanej komórce określonym tekstem i zwraca liczbę zastąpień.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
replace | String | Tekst, który zastępuje zawartość w aktualnie dopasowanej komórce. |
Powrót
Integer – liczba zastąpionych wystąpień.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Konfiguruje wyszukiwanie tak, aby rozpoczynało się natychmiast po określonym zakresie komórek.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
start | Range | Zakres komórek, po którym należy rozpocząć wyszukiwanie. |
Powrót
TextFinder – ten wyszukiwacz tekstu do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
Jeśli true, konfiguruje wyszukiwanie tak, aby ciąg wyszukiwania był interpretowany jako wyrażenie regularne. W przeciwnym razie ciąg wyszukiwania jest interpretowany jako zwykły tekst. Więcej informacji o używaniu wyrażeń regularnych znajdziesz na
stronie pomocy dotyczącej znajdowania i zastępowania.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
use | Boolean | Określa, czy ciąg wyszukiwania ma być interpretowany jako wyrażenie regularne. |
Powrót
TextFinder – ten wyszukiwacz tekstu do łączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets