Diese Seite wurde von der Cloud Translation API übersetzt.

Class TextFinder

Text in einem Bereich, auf einem Tabellenblatt oder in einer Tabelle suchen oder ersetzen Sie können 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`	Wenn `true` festgelegt ist, werden bei der Suche diakritische Zeichen ignoriert. Andernfalls werden sie berücksichtigt.
`matchCase(matchCase)`	`TextFinder`	Wenn `true`, wird die Suche so konfiguriert, dass die Groß- und Kleinschreibung des Suchtexts genau übereinstimmt. Andernfalls wird bei der Suche standardmäßig nicht zwischen Groß- und Kleinschreibung unterschieden.
`matchEntireCell(matchEntireCell)`	`TextFinder`	Wenn `true` festgelegt ist, wird die Suche so konfiguriert, dass der gesamte Inhalt einer Zelle abgeglichen wird. Andernfalls wird standardmäßig eine teilweise Übereinstimmung verwendet.
`matchFormulaText(matchFormulaText)`	`TextFinder`	Wenn `true` festgelegt ist, werden bei der Suche Übereinstimmungen zurückgegeben, die im Formeltext vorkommen. Andernfalls werden Zellen mit Formeln anhand ihres angezeigten Werts 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`	Die Suche wird so konfiguriert, dass sie unmittelbar nach dem angegebenen Zellenbereich beginnt.
`useRegularExpression(useRegEx)`	`TextFinder`	Wenn `true`, wird die Suche so konfiguriert, dass der Suchstring als regulärer Ausdruck interpretiert wird. Andernfalls wird der Suchstring als normaler Text interpretiert.

Detaillierte Dokumentation

`findAll()`

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

Rückflug

Range[]: Alle übereinstimmenden Zellen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

Range: Die aktuelle übereinstimmende Zelle oder null, wenn keine weiteren Übereinstimmungen vorhanden sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`ignoreDiacritics(ignoreDiacritics)`

Wenn true festgelegt ist, werden bei der Suche diakritische Zeichen ignoriert. Andernfalls werden sie berücksichtigt. Ein diakritisches Zeichen ist ein Zeichen, z. B. ein Akzent oder eine Cedille, das über oder unter einem Buchstaben geschrieben wird und einen Unterschied in der Aussprache desselben Buchstabens angibt, wenn er nicht oder anders gekennzeichnet ist.

Parameter

Name	Typ	Beschreibung
`ignoreDiacritics`	`Boolean`	Gibt an, ob bei der Suche Akzente berücksichtigt werden.

Rückflug

TextFinder – Dieser Textsuchmechanismus kann verschachtelt werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`matchCase(matchCase)`

Wenn true, wird die Suche so konfiguriert, dass die Groß- und Kleinschreibung des Suchtexts genau übereinstimmt. Andernfalls wird bei der Suche standardmäßig nicht zwischen Groß- und Kleinschreibung unterschieden.

Parameter

Name	Typ	Beschreibung
`matchCase`	`Boolean`	Ob bei der Übereinstimmung zwischen Groß- und Kleinschreibung unterschieden wird.

Rückflug

TextFinder – Dieser Textsuchmechanismus kann verschachtelt werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`matchEntireCell(matchEntireCell)`

Wenn true festgelegt ist, wird die Suche so konfiguriert, dass der gesamte Inhalt einer Zelle abgeglichen wird. Andernfalls wird standardmäßig eine teilweise Übereinstimmung verwendet.

Parameter

Name	Typ	Beschreibung
`matchEntireCell`	`Boolean`	Gibt an, ob die gesamte Zelle abgeglichen werden soll.

Rückflug

TextFinder – Dieser Textsuchmechanismus kann verschachtelt werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`matchFormulaText(matchFormulaText)`

Wenn true festgelegt ist, werden bei der Suche Übereinstimmungen zurückgegeben, die im Formeltext vorkommen. Andernfalls werden Zellen mit Formeln anhand ihres angezeigten Werts berücksichtigt.

Parameter

Name	Typ	Beschreibung
`matchFormulaText`	`Boolean`	Gibt an, ob bei der Suche der Formeltext berücksichtigt werden soll.

Rückflug

TextFinder – Dieser Textsuchmechanismus kann verschachtelt werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

Integer: Die Anzahl der ersetzten Vorkommen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 der aktuell übereinstimmenden Zelle ersetzt.

Rückflug

Integer: Die Anzahl der ersetzten Vorkommen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`startFrom(startRange)`

Die Suche wird so konfiguriert, dass sie unmittelbar nach dem angegebenen Zellenbereich beginnt.

Parameter

Name	Typ	Beschreibung
`startRange`	`Range`	Der Zellenbereich, nach dem die Suche beginnen soll.

Rückflug

TextFinder – Dieser Textsuchmechanismus kann verschachtelt werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`useRegularExpression(useRegEx)`

Wenn true, wird die Suche so konfiguriert, dass der Suchstring als regulärer Ausdruck interpretiert wird. Andernfalls wird der Suchstring als normaler 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.

Rückflug

TextFinder – Dieser Textsuchmechanismus kann verschachtelt werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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