Znajdowanie i 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 pasujące do kryteriów wyszukiwania. |
find | Range | Zwraca następną komórkę pasującą do kryteriów wyszukiwania. |
find | Range | Zwraca poprzednią komórkę pasującą do kryteriów wyszukiwania. |
get | Range | Zwraca bieżącą komórkę pasującą do kryteriów wyszukiwania. |
ignore | Text | Jeśli true , wyszukiwanie ignoruje znaki diakrytyczne podczas dopasowywania. W przeciwnym razie wyszukiwanie uwzględnia znaki diakrytyczne. |
match | Text | Jeśli true , wyszukiwanie jest dopasowywane dokładnie do wielkości liter tekstu wyszukiwanego, w przeciwnym razie wyszukiwanie jest dopasowywane bez uwzględniania wielkości liter. |
match | Text | Jeśli true , skonfiguruj wyszukiwanie tak, aby pasowało do całej zawartości komórki. W przeciwnym razie wyszukiwanie dopasuje się do częściowego dopasowania. |
match | Text | Jeśli true , skonfiguruj wyszukiwanie tak, aby zwracało dopasowania, które pojawiają się 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 wyszukiwany w bieżącej komórce dopasowania podanym tekstem i zwraca liczbę zastąpionych wystąpień. |
start | Text | Skonfiguruj wyszukiwanie tak, aby zaczęło się od razu po określonym zakresie komórek. |
use | Text | Jeśli true , wyszukiwanie interpretuje ciąg wyszukiwania jako wyrażenie regularne. W przeciwnym razie ciąg wyszukiwania jest interpretowany jako zwykły tekst. |
Szczegółowa dokumentacja
find All()
Zwraca wszystkie komórki pasujące do kryteriów wyszukiwania.
Powrót
Range[]
– wszystkie pasujące komórki.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
find Next()
Zwraca następną komórkę pasującą do kryteriów wyszukiwania.
Powrót
Range
– następna komórka z dopasowaniem lub null
, jeśli nie ma poprzednich dopasowań.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
find Previous()
Zwraca poprzednią komórkę pasującą do kryteriów wyszukiwania.
Powrót
Range
– poprzednia komórka z dopasowaniem lub null
, jeśli nie ma poprzednich dopasowań.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Current Match()
Zwraca bieżącą komórkę pasującą do kryteriów wyszukiwania.
Powrót
Range
– bieżąca komórka pasująca do danych, lub null
, jeśli nie ma dalszych dopasowań.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ignore Diacritics(ignoreDiacritics)
Jeśli true
, wyszukiwanie ignoruje znaki diakrytyczne podczas dopasowywania. W przeciwnym razie wyszukiwanie uwzględnia znaki diakrytyczne. Znak diakrytyczny to znak, np. akcent lub cedila, który zapisany nad lub pod literą wskazuje różnicę w wymowie tej samej litery w porównaniu z wymową tej litery, gdy nie jest ona oznaczona lub jest oznaczona inaczej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ignore | Boolean | Określa, czy wyszukiwanie uwzględnia znaki diakrytyczne. |
Powrót
Text
– ten tekst wyszukiwania, do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
match Case(matchCase)
Jeśli true
, wyszukiwanie jest dopasowywane dokładnie do wielkości liter tekstu wyszukiwanego, w przeciwnym razie wyszukiwanie jest dopasowywane bez uwzględniania wielkości liter.
Parametry
Nazwa | Typ | Opis |
---|---|---|
match | Boolean | Określa, czy podczas dopasowywania jest rozróżniana wielkość liter. |
Powrót
Text
– ten wyszukiwacz tekstu, do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
match Entire Cell(matchEntireCell)
Jeśli true
, skonfiguruj wyszukiwanie tak, aby pasowało do całej zawartości komórki. W przeciwnym razie wyszukiwanie dopasuje się do częściowego dopasowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
match | Boolean | Określa, czy dopasowanie dotyczy całej komórki. |
Powrót
Text
– ten wyszukiwacz tekstu do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
match Formula Text(matchFormulaText)
Jeśli true
, skonfiguruj wyszukiwanie tak, aby zwracało dopasowania, które pojawiają się 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 ma sprawdzać tekst formuły. |
Powrót
Text
– ten wyszukiwacz tekstu, do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace All With(replaceText)
Zastępuje wszystkie dopasowania określonym tekstem. Zwraca liczbę zastąpionych wystąpień, która może być inna niż liczba dopasowanych komórek.
Parametry
Nazwa | Typ | Opis |
---|---|---|
replace | String | Tekst, który zastępuje tekst w dopasowanych komórkach. |
Powrót
Integer
– liczba zastąpionych wystąpień.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace With(replaceText)
Zastępuje tekst wyszukiwany w bieżącej komórce dopasowania podanym tekstem i zwraca liczbę zastąpionych wystąpień.
Parametry
Nazwa | Typ | Opis |
---|---|---|
replace | String | Tekst, który zastępuje zawartość w bieżąco dopasowanej komórce. |
Powrót
Integer
– liczba zastąpionych wystąpień.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
start From(startRange)
Skonfiguruj wyszukiwanie tak, aby zaczęło się od razu po określonym zakresie komórek.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Range | Zakres komórek, od których ma się rozpocząć wyszukiwanie. |
Powrót
Text
– ten wyszukiwacz tekstu do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
use Regular Expression(useRegEx)
Jeśli true
, wyszukiwanie interpretuje ciąg wyszukiwania 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 poświęconej znajdowaniu i zastępowaniu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
use | Boolean | Określa, czy ciąg wyszukiwania ma być interpretowany jako wyrażenie regularne. |
Powrót
Text
– ten tekst wyszukiwania, do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets