Class TextFinder

TekstFinder

Znajdowanie i zastępowanie tekstu w zakresie, arkuszu lub arkuszu kalkulacyjnym. Możesz też określić opcje wyszukiwania.

Metody

MetodaZwracany typKrótki opis
findAll()Range[]Zwraca wszystkie komórki pasujące do kryteriów wyszukiwania.
findNext()RangeZwraca następną komórkę pasującą do kryteriów wyszukiwania.
findPrevious()RangeZwraca poprzednią komórkę pasującą do kryteriów wyszukiwania.
getCurrentMatch()RangeZwraca bieżącą komórkę pasującą do kryteriów wyszukiwania.
ignoreDiacritics(ignoreDiacritics)TextFinderJeśli true, wyszukiwanie ignoruje znaki diakrytyczne podczas dopasowywania. W przeciwnym razie wyszukiwanie uwzględnia znaki diakrytyczne.
matchCase(matchCase)TextFinderJeś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.
matchEntireCell(matchEntireCell)TextFinderJeś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.
matchFormulaText(matchFormulaText)TextFinderJeś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.
replaceAllWith(replaceText)IntegerZastępuje wszystkie dopasowania określonym tekstem.
replaceWith(replaceText)IntegerZastępuje tekst wyszukiwany w bieżącej komórce dopasowania podanym tekstem i zwraca liczbę zastąpionych wystąpień.
startFrom(startRange)TextFinderSkonfiguruj wyszukiwanie tak, aby zaczęło się od razu po określonym zakresie komórek.
useRegularExpression(useRegEx)TextFinderJeś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

findAll()

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

findNext()

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

findPrevious()

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

getCurrentMatch()

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

ignoreDiacritics(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

NazwaTypOpis
ignoreDiacriticsBooleanOkreśla, czy wyszukiwanie uwzględnia znaki diakrytyczne.

Powrót

TextFinder – 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

matchCase(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

NazwaTypOpis
matchCaseBooleanOkreśla, czy podczas dopasowywania jest rozróżniana wielkość liter.

Powrót

TextFinder – 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

matchEntireCell(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

NazwaTypOpis
matchEntireCellBooleanOkreśla, czy dopasowanie dotyczy całej komórki.

Powrót

TextFinder – 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

matchFormulaText(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

NazwaTypOpis
matchFormulaTextBooleanOkreśla, czy wyszukiwanie ma sprawdzać tekst formuły.

Powrót

TextFinder – 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

replaceAllWith(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

NazwaTypOpis
replaceTextStringTekst, 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

replaceWith(replaceText)

Zastępuje tekst wyszukiwany w bieżącej komórce dopasowania podanym tekstem i zwraca liczbę zastąpionych wystąpień.

Parametry

NazwaTypOpis
replaceTextStringTekst, 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

startFrom(startRange)

Skonfiguruj wyszukiwanie tak, aby zaczęło się od razu po określonym zakresie komórek.

Parametry

NazwaTypOpis
startRangeRangeZakres komórek, od których ma się rozpocząć wyszukiwanie.

Powrót

TextFinder – 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

useRegularExpression(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

NazwaTypOpis
useRegExBooleanOkreśla, czy ciąg wyszukiwania ma być interpretowany jako wyrażenie regularne.

Powrót

TextFinder – 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