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