Class TextFinder

TextFinder

Text in einem Bereich, einem Tabellenblatt oder einer Tabelle suchen oder ersetzen Kann auch Suchoptionen angeben.

Methoden

MethodeRückgabetypKurzbeschreibung
findAll()Range[]Gibt alle Zellen zurück, die den Suchkriterien entsprechen.
findNext()RangeGibt die nächste Zelle zurück, die den Suchkriterien entspricht.
findPrevious()RangeGibt die vorherige Zelle zurück, die den Suchkriterien entspricht.
getCurrentMatch()RangeGibt die aktuelle Zelle zurück, die den Suchkriterien entspricht.
ignoreDiacritics(ignoreDiacritics)TextFinderBei true wird die Suche so konfiguriert, dass diakritische Zeichen beim Abgleich ignoriert werden. Andernfalls werden diakritische Zeichen bei der Suche abgeglichen.
matchCase(matchCase)TextFinderBei true wird die Suche so konfiguriert, dass sie genau mit der Groß-/Kleinschreibung des Suchtexts übereinstimmt. Andernfalls wird standardmäßig die Groß-/Kleinschreibung berücksichtigt.
matchEntireCell(matchEntireCell)TextFinderWenn true, wird die Suche so konfiguriert, dass sie mit dem gesamten Inhalt einer Zelle übereinstimmt. Andernfalls wird standardmäßig eine teilweise Übereinstimmung verwendet.
matchFormulaText(matchFormulaText)TextFinderWenn true, wird die Suche so konfiguriert, dass Übereinstimmungen zurückgegeben werden, die im Formeltext enthalten sind. Andernfalls werden Zellen mit Formeln basierend auf ihrem angezeigten Wert berücksichtigt.
replaceAllWith(replaceText)IntegerErsetzt alle Übereinstimmungen durch den angegebenen Text.
replaceWith(replaceText)IntegerErsetzt den Suchtext in der aktuell übereinstimmenden Zelle durch den angegebenen Text und gibt die Anzahl der ersetzten Vorkommen zurück.
startFrom(startRange)TextFinderKonfiguriert die Suche so, dass die Suche direkt nach dem angegebenen Zellenbereich beginnt.
useRegularExpression(useRegEx)TextFinderBei true wird die Suche so konfiguriert, dass der Suchstring als regulärer Ausdruck interpretiert wird. Andernfalls wird der Suchstring als normalen Text interpretiert.

Detaillierte Dokumentation

findAll()

Gibt alle Zellen zurück, die den Suchkriterien entsprechen.

Return

Range[]: Alle übereinstimmenden Zellen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

findNext()

Gibt die nächste Zelle zurück, die den Suchkriterien entspricht.

Return

Range: Die nächste übereinstimmende Zelle oder null, wenn es keine vorherigen Übereinstimmungen gibt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

findPrevious()

Gibt die vorherige Zelle zurück, die den Suchkriterien entspricht.

Return

Range: Die vorherige übereinstimmende Zelle oder null, wenn es keine vorherigen Übereinstimmungen gibt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getCurrentMatch()

Gibt die aktuelle Zelle zurück, die den Suchkriterien entspricht.

Return

Range: Die aktuell übereinstimmende Zelle oder null, wenn es keine weiteren Übereinstimmungen gibt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

ignoreDiacritics(ignoreDiacritics)

Bei true wird die Suche so konfiguriert, dass diakritische Zeichen beim Abgleich ignoriert werden. Andernfalls werden diakritische Zeichen bei der Suche abgeglichen. Ein diakritisches Zeichen ist ein Zeichen, z. B. ein Akzent oder eine Cedille, die oberhalb oder unterhalb eines Buchstabens geschrieben wird, um eine Abweichung in der Aussprache desselben Buchstabens anzuzeigen, wenn er nicht markiert oder anders markiert ist.

Parameter

NameTypBeschreibung
ignoreDiacriticsBooleanWerden bei der Suche diakritische Zeichen berücksichtigt?

Return

TextFinder: Textsuche zum Verketten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

matchCase(matchCase)

Bei true wird die Suche so konfiguriert, dass sie genau mit der Groß-/Kleinschreibung des Suchtexts übereinstimmt. Andernfalls wird standardmäßig die Groß-/Kleinschreibung berücksichtigt.

Parameter

NameTypBeschreibung
matchCaseBooleanGibt an, ob beim Abgleich zwischen Groß- und Kleinschreibung unterschieden wird.

Return

TextFinder: Textsuche zum Verketten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

matchEntireCell(matchEntireCell)

Wenn true, wird die Suche so konfiguriert, dass sie mit dem gesamten Inhalt einer Zelle übereinstimmt. Andernfalls wird standardmäßig eine teilweise Übereinstimmung verwendet.

Parameter

NameTypBeschreibung
matchEntireCellBooleanGibt an, ob eine Übereinstimmung mit der gesamten Zelle gefunden wird.

Return

TextFinder: Textsuche zum Verketten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

matchFormulaText(matchFormulaText)

Wenn true, wird die Suche so konfiguriert, dass Übereinstimmungen zurückgegeben werden, die im Formeltext enthalten sind. Andernfalls werden Zellen mit Formeln basierend auf ihrem angezeigten Wert berücksichtigt.

Parameter

NameTypBeschreibung
matchFormulaTextBooleanGibt an, ob die Suche Formeltext untersucht.

Return

TextFinder: Textsuche zum Verketten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

replaceAllWith(replaceText)

Ersetzt alle Übereinstimmungen durch den angegebenen Text. Gibt die Anzahl der ersetzten Vorkommen zurück. Diese kann von der Anzahl der übereinstimmenden Zellen abweichen.

Parameter

NameTypBeschreibung
replaceTextStringDer Text, der den Text in den übereinstimmenden Zellen ersetzt.

Return

Integer: Die Anzahl der ersetzten Vorgänge.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

replaceWith(replaceText)

Ersetzt den Suchtext in der aktuell übereinstimmenden Zelle durch den angegebenen Text und gibt die Anzahl der ersetzten Vorkommen zurück.

Parameter

NameTypBeschreibung
replaceTextStringDer Text, der den Inhalt in der aktuell übereinstimmenden Zelle ersetzt.

Return

Integer: Die Anzahl der ersetzten Vorgänge.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

startFrom(startRange)

Konfiguriert die Suche so, dass die Suche direkt nach dem angegebenen Zellenbereich beginnt.

Parameter

NameTypBeschreibung
startRangeRangeZellenbereich, nach dem die Suche beginnen soll

Return

TextFinder: Textsuche zum Verketten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

useRegularExpression(useRegEx)

Bei true wird die Suche so konfiguriert, dass der Suchstring als regulärer Ausdruck interpretiert wird. Andernfalls wird der Suchstring als normalen Text interpretiert. Weitere Informationen zur Verwendung regulärer Ausdrücke finden Sie auf der Supportseite „Suchen und ersetzen“.

Parameter

NameTypBeschreibung
useRegExBooleanGibt an, ob der Suchstring als regulärer Ausdruck interpretiert werden soll.

Return

TextFinder: Textsuche zum Verketten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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