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

Class TextFinder

Znajdź lub zastąp tekst 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ę pasującą do kryteriów wyszukiwania.
`getCurrentMatch()`	`Range`	Zwraca bieżącą komórkę spełniającą kryteria wyszukiwania.
`ignoreDiacritics(ignoreDiacritics)`	`TextFinder`	Jeśli `true` używa znaków diakrytycznych, wyszukiwanie będzie ignorować znaki diakrytyczne podczas dopasowywania. W przeciwnym razie zapytania będą uwzględniać znaki diakrytyczne.
`matchCase(matchCase)`	`TextFinder`	Jeśli `true` dopasowuje wielkość liter w wyszukiwanym tekście. W przeciwnym razie domyślnie nie będzie rozróżniana wielkość liter.
`matchEntireCell(matchEntireCell)`	`TextFinder`	Jeśli `true` konfiguruje wyszukiwanie do całej zawartości komórki. W przeciwnym razie wyszukiwanie domyślnie stosuje dopasowanie częściowe.
`matchFormulaText(matchFormulaText)`	`TextFinder`	Jeśli funkcja `true` jest skonfigurowana, wyszukiwanie zwraca dopasowania pojawiające się w tekście formuły. W przeciwnym razie komórki z formułami są rozpatrywane na podstawie ich wyświetlanej wartości.
`replaceAllWith(replaceText)`	`Integer`	Zastępuje wszystkie dopasowania określonym tekstem.
`replaceWith(replaceText)`	`Integer`	Zastępuje wyszukiwany tekst w aktualnie zgodnej komórce określonym tekstem i zwraca liczbę zastąpionych wystąpień.
`startFrom(startRange)`	`TextFinder`	Konfiguruje wyszukiwanie tak, aby wyszukiwanie rozpoczynało się natychmiast po określonym zakresie komórek.
`useRegularExpression(useRegEx)`	`TextFinder`	Jeśli ustawiona jest wartość `true`, wyszukiwanie interpretuje wyszukiwany ciąg znaków jako wyrażenie regularne. W przeciwnym razie wyszukiwanie zinterpretuje go jako zwykły tekst.

Szczegółowa dokumentacja

`findAll()`

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

Powroty

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

Upoważnienie

Skrypty korzystające 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

`findNext()`

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

Powroty

Range – następna pasująca komórka lub null, jeśli nie ma poprzednich dopasowań.

Upoważnienie

Skrypty korzystające 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

`findPrevious()`

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

Powroty

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

Upoważnienie

Skrypty korzystające 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

`getCurrentMatch()`

Zwraca bieżącą komórkę spełniającą kryteria wyszukiwania.

Powroty

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

Upoważnienie

Skrypty korzystające 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

`ignoreDiacritics(ignoreDiacritics)`

Jeśli true używa znaków diakrytycznych, wyszukiwanie będzie ignorować znaki diakrytyczne podczas dopasowywania. W przeciwnym razie zapytania będą uwzględniać znaki diakrytyczne. Znak diakrytyczny to znak, np. akcent lub cedylla. Napisany nad literą lub pod literą oznacza występowanie różnicy w wymowie tej samej litery, jeśli jest nieoznaczony lub oznaczony inaczej.

Parametry

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

Powroty

TextFinder – wyszukiwarka tekstu do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające 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

`matchCase(matchCase)`

Jeśli true dopasowuje wielkość liter w wyszukiwanym tekście. W przeciwnym razie domyślnie nie będzie rozróżniana wielkość liter.

Parametry

Nazwa	Typ	Opis
`matchCase`	`Boolean`	Określa, czy w dopasowywaniu wielkość liter ma znaczenie.

Powroty

TextFinder – wyszukiwarka tekstu do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające 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

`matchEntireCell(matchEntireCell)`

Jeśli true konfiguruje wyszukiwanie do całej zawartości komórki. W przeciwnym razie wyszukiwanie domyślnie stosuje dopasowanie częściowe.

Parametry

Nazwa	Typ	Opis
`matchEntireCell`	`Boolean`	Wskazuje, czy dopasowanie obejmuje całą komórkę.

Powroty

TextFinder – wyszukiwarka tekstu do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające 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

`matchFormulaText(matchFormulaText)`

Jeśli funkcja true jest skonfigurowana, wyszukiwanie zwraca dopasowania pojawiające się w tekście formuły. W przeciwnym razie komórki z formułami są rozpatrywane na podstawie ich wyświetlanej wartości.

Parametry

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

Powroty

TextFinder – wyszukiwarka tekstu do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające 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

`replaceAllWith(replaceText)`

Zastępuje wszystkie dopasowania określonym tekstem. Zwraca liczbę zastąpionych wystąpień, która może różnić się od liczby pasujących komórek.

Parametry

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

Powroty

Integer – liczba zastąpionych wystąpień.

Upoważnienie

Skrypty korzystające 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

`replaceWith(replaceText)`

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

Parametry

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

Powroty

Integer – liczba zastąpionych wystąpień.

Upoważnienie

Skrypty korzystające 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

`startFrom(startRange)`

Konfiguruje wyszukiwanie tak, aby wyszukiwanie rozpoczynało się natychmiast po określonym zakresie komórek.

Parametry

Nazwa	Typ	Opis
`startRange`	`Range`	Zakres komórek, w którym ma się rozpocząć wyszukiwanie.

Powroty

TextFinder – wyszukiwarka tekstu do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające 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

`useRegularExpression(useRegEx)`

Jeśli ustawiona jest wartość true, wyszukiwanie interpretuje wyszukiwany ciąg znaków jako wyrażenie regularne. W przeciwnym razie wyszukiwanie zinterpretuje go jako zwykły tekst. Więcej informacji o korzystaniu z wyrażeń regularnych znajdziesz na stronie pomocy dotyczącej znajdowania i zastępowania.

Parametry

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

Powroty

TextFinder – wyszukiwarka tekstu do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające 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