Diese Seite wurde von der Cloud Translation API übersetzt.

Class TextFinder

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`findAll()`	`Range[]`	Gibt alle Zellen zurück, die den Suchkriterien entsprechen.
`findNext()`	`Range`	Gibt die nächste Zelle zurück, die den Suchkriterien entspricht.
`findPrevious()`	`Range`	Gibt die vorherige Zelle zurück, die den Suchkriterien entspricht.
`getCurrentMatch()`	`Range`	Gibt die aktuelle Zelle zurück, die den Suchkriterien entspricht.
`ignoreDiacritics(ignoreDiacritics)`	`TextFinder`	Bei `true` wird die Suche so konfiguriert, dass diakritische Zeichen beim Abgleich ignoriert werden. Andernfalls werden diakritische Zeichen bei der Suche abgeglichen.
`matchCase(matchCase)`	`TextFinder`	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.
`matchEntireCell(matchEntireCell)`	`TextFinder`	Wenn `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)`	`TextFinder`	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.
`replaceAllWith(replaceText)`	`Integer`	Ersetzt alle Übereinstimmungen durch den angegebenen Text.
`replaceWith(replaceText)`	`Integer`	Ersetzt den Suchtext in der aktuell übereinstimmenden Zelle durch den angegebenen Text und gibt die Anzahl der ersetzten Vorkommen zurück.
`startFrom(startRange)`	`TextFinder`	Konfiguriert die Suche so, dass die Suche direkt nach dem angegebenen Zellenbereich beginnt.
`useRegularExpression(useRegEx)`	`TextFinder`	Bei `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

Name	Typ	Beschreibung
`ignoreDiacritics`	`Boolean`	Werden 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

Name	Typ	Beschreibung
`matchCase`	`Boolean`	Gibt 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

Name	Typ	Beschreibung
`matchEntireCell`	`Boolean`	Gibt 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

Name	Typ	Beschreibung
`matchFormulaText`	`Boolean`	Gibt 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

Name	Typ	Beschreibung
`replaceText`	`String`	Der 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

Name	Typ	Beschreibung
`replaceText`	`String`	Der 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

Name	Typ	Beschreibung
`startRange`	`Range`	Zellenbereich, 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

Name	Typ	Beschreibung
`useRegEx`	`Boolean`	Gibt 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