Ta strona została przetłumaczona przez Cloud Translation API.

Class TextFinder

Wyszukiwanie i zastępowanie tekstu w zakresie, arkuszu lub arkuszu kalkulacyjnym. Może też określać opcje wyszukiwania.

Metody

Metoda	Zwracany typ	Krótki opis
`findAll()`	`Range[]`	Zwraca wszystkie komórki pasujące do kryteriów wyszukiwania.
`findNext()`	`Range`	Zwraca następną komórkę pasującą do kryteriów wyszukiwania.
`findPrevious()`	`Range`	Zwraca poprzednią komórkę, która spełnia kryteria wyszukiwania.
`getCurrentMatch()`	`Range`	Zwraca aktualną komórkę pasującą do kryteriów wyszukiwania.
`ignoreDiacritics(ignoreDiacritics)`	`TextFinder`	Jeśli `true` określa wyszukiwanie tak, aby ignorować znaki diakrytyczne podczas dopasowywania, w przeciwnym razie będzie pasować do znaków diakrytycznych.
`matchCase(matchCase)`	`TextFinder`	Jeśli `true` ma skonfigurowane dokładnie dopasowanie do tekstu wyszukiwania, w przeciwnym razie domyślnie rozróżniana jest wielkość liter.
`matchEntireCell(matchEntireCell)`	`TextFinder`	Jeśli `true` ma skonfigurowane wyszukiwanie tak, aby pasowało do całej zawartości komórki, a w przeciwnym razie wyszukiwanie jest domyślnie ograniczone do częściowego.
`matchFormulaText(matchFormulaText)`	`TextFinder`	Jeśli `true` ma skonfigurowane wyszukiwanie w taki sposób, aby zwracać dopasowania, które pojawiają się w tekście formuły. W przeciwnym razie komórki z formułami są uznawane za wyświetlane na podstawie ich wartości.
`replaceAllWith(replaceText)`	`Integer`	Zastępuje wszystkie dopasowania określonym tekstem.
`replaceWith(replaceText)`	`Integer`	Zastępuje wyszukiwany tekst w aktualnie wybranej komórce określonym tekstem i zwraca liczbę wystąpień wystąpień.
`startFrom(startRange)`	`TextFinder`	Konfiguruje wyszukiwanie bezpośrednio po określonym zakresie komórek.
`useRegularExpression(useRegEx)`	`TextFinder`	Jeśli `true`, wyszukiwanie zostanie zinterpretowane jako wyrażenie regularne. W przeciwnym razie wyniki wyszukiwania będą interpretowane jako zwykły tekst.

Szczegółowa dokumentacja

`findAll()`

Zwraca wszystkie komórki pasujące do kryteriów wyszukiwania.

Zwróć

Range[] – wszystkie pasujące komórki;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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ę pasującą do kryteriów wyszukiwania.

Zwróć

Range – kolejna pasująca komórka lub null, jeśli nie ma wcześniejszych dopasowań.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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ę, która spełnia kryteria wyszukiwania.

Zwróć

Range – poprzednia pasująca komórka lub null, jeśli nie ma pasujących dopasowań.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCurrentMatch()`

Zwraca aktualną komórkę pasującą do kryteriów wyszukiwania.

Zwróć

Range – bieżąca pasująca komórka lub null, jeśli nie ma dalszych dopasowań.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 określa wyszukiwanie tak, aby ignorować znaki diakrytyczne podczas dopasowywania, w przeciwnym razie będzie pasować do znaków diakrytycznych. Znak diakrytyczny to znak, np. akcent lub cedry, które po oznaczeniu nad lub pod literą wskazują, że różni się wymowa tej samej litery, jeśli nie została oznaczona.

Parametry

Nazwa	Typ	Opis
`ignoreDiacritics`	`Boolean`	Określa, czy wyszukiwanie uwzględnia znaki diakrytyczne.

Zwróć

TextFinder – ten edytor tekstu do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 ma skonfigurowane dokładnie dopasowanie do tekstu wyszukiwania, w przeciwnym razie domyślnie rozróżniana jest wielkość liter.

Parametry

Nazwa	Typ	Opis
`matchCase`	`Boolean`	Określa, czy podczas dopasowywania rozróżniana jest wielkość liter.

Zwróć

TextFinder – ten edytor tekstu do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 ma skonfigurowane wyszukiwanie tak, aby pasowało do całej zawartości komórki, a w przeciwnym razie wyszukiwanie jest domyślnie ograniczone do częściowego.

Parametry

Nazwa	Typ	Opis
`matchEntireCell`	`Boolean`	Określa, czy cała komórka jest dopasowana.

Zwróć

TextFinder – ten edytor tekstu do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 ma skonfigurowane wyszukiwanie w taki sposób, aby zwracać dopasowania, które pojawiają się w tekście formuły. W przeciwnym razie komórki z formułami są uznawane za wyświetlane na podstawie ich wartości.

Parametry

Nazwa	Typ	Opis
`matchFormulaText`	`Boolean`	Określa, czy wyszukiwanie analizuje tekst formuły.

Zwróć

TextFinder – ten edytor tekstu do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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ę wystąpień wystąpień, która może być inna niż liczba dopasowanych komórek.

Parametry

Nazwa	Typ	Opis
`replaceText`	`String`	Tekst, który zastępuje tekst w dopasowanych komórkach.

Zwróć

Integer – liczba zastąpionych wystąpień.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`replaceWith(replaceText)`

Zastępuje wyszukiwany tekst w aktualnie wybranej komórce określonym tekstem i zwraca liczbę wystąpień wystąpień.

Parametry

Nazwa	Typ	Opis
`replaceText`	`String`	Tekst, który zastępuje zawartość obecnie dopasowanej komórki.

Zwróć

Integer – liczba zastąpionych wystąpień.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`startFrom(startRange)`

Konfiguruje wyszukiwanie bezpośrednio po określonym zakresie komórek.

Parametry

Nazwa	Typ	Opis
`startRange`	`Range`	Zakres komórek, po których powinno się rozpocząć wyszukiwanie.

Zwróć

TextFinder – ten edytor tekstu do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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, wyszukiwanie zostanie zinterpretowane jako wyrażenie regularne. W przeciwnym razie wyniki wyszukiwania będą interpretowane jako zwykły tekst. Więcej informacji o korzystaniu z wyrażeń regularnych znajdziesz na stronie pomocy Znajdź i zamień.

Parametry

Nazwa	Typ	Opis
`useRegEx`	`Boolean`	Określa, czy ciąg wyszukiwania ma być zapisany jako wyrażenie regularne.

Zwróć

TextFinder – ten edytor tekstu do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets