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