Class TextFinder

TextFinder

Text in einem Bereich, Tabellenblatt oder einer Tabelle suchen oder ersetzen Sie können 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)TextFinderWenn true, wird die Suche so konfiguriert, dass diakritische Zeichen beim Abgleich ignoriert werden. Andernfalls werden diakritische Zeichen berücksichtigt.
matchCase(matchCase)TextFinderWenn true, wird die Suche so konfiguriert, dass die Groß-/Kleinschreibung des Suchtexts genau übereinstimmen muss. Andernfalls wird standardmäßig nicht zwischen Groß- und Kleinschreibung unterschieden.
matchEntireCell(matchEntireCell)TextFinderWenn true, wird die Suche so konfiguriert, dass der gesamte Inhalt einer Zelle übereinstimmen muss. Andernfalls wird standardmäßig ein teilweiser Abgleich durchgeführt.
matchFormulaText(matchFormulaText)TextFinderWenn true, wird die Suche so konfiguriert, dass Übereinstimmungen zurückgegeben werden, die im Formeltext enthalten sind. Andernfalls werden Zellen mit Formeln anhand ihres angezeigten Werts berücksichtigt.
replaceAllWith(replaceText)IntegerErsetzt alle Treffer durch den angegebenen Text.
replaceWith(replaceText)IntegerErsetzt den Suchtext in der aktuell übereinstimmenden Zelle durch den angegebenen Text und gibt die Anzahl der Ersetzungen zurück.
startFrom(startRange)TextFinderKonfiguriert die Suche so, dass sie unmittelbar nach dem angegebenen Zellbereich beginnt.
useRegularExpression(useRegEx)TextFinderWenn 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

ignoreDiacritics(ignoreDiacritics)

Wenn true, wird die Suche so konfiguriert, dass diakritische Zeichen beim Abgleich ignoriert werden. Andernfalls werden diakritische Zeichen berücksichtigt. Ein diakritisches Zeichen ist ein Zeichen wie ein Akzent oder eine Cedille, das über oder unter einem Buchstaben geschrieben wird und eine andere Aussprache als der gleiche Buchstabe ohne oder mit einem anderen diakritischen Zeichen angibt.

Parameter

NameTypBeschreibung
ignoreDiacriticsBooleanGibt an, ob bei der Suche diakritische Zeichen berücksichtigt werden.

Rückflug

TextFinder – Dieser Textfinder zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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ß-/Kleinschreibung des Suchtexts genau übereinstimmen muss. Andernfalls wird standardmäßig nicht zwischen Groß- und Kleinschreibung unterschieden.

Parameter

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

Rückflug

TextFinder – Dieser Textfinder zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

matchEntireCell(matchEntireCell)

Wenn true, wird die Suche so konfiguriert, dass der gesamte Inhalt einer Zelle übereinstimmen muss. Andernfalls wird standardmäßig ein teilweiser Abgleich durchgeführt.

Parameter

NameTypBeschreibung
matchEntireCellBooleanGibt an, ob die gesamte Zelle übereinstimmt.

Rückflug

TextFinder – Dieser Textfinder zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 anhand ihres angezeigten Werts berücksichtigt.

Parameter

NameTypBeschreibung
matchFormulaTextBooleanGibt an, ob bei der Suche Formeltext berücksichtigt wird.

Rückflug

TextFinder – Dieser Textfinder zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

replaceAllWith(replaceText)

Ersetzt alle Treffer durch den angegebenen Text. Gibt die Anzahl der ersetzten Vorkommen zurück. Diese kann sich von der Anzahl der übereinstimmenden Zellen unterscheiden.

Parameter

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

Rückflug

Integer: Die Anzahl der ersetzten Vorkommen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Ersetzungen zurück.

Parameter

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

Rückflug

Integer: Die Anzahl der ersetzten Vorkommen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

startFrom(startRange)

Konfiguriert die Suche so, dass sie unmittelbar nach dem angegebenen Zellbereich beginnt.

Parameter

NameTypBeschreibung
startRangeRangeDer Zellbereich, nach dem die Suche beginnen soll.

Rückflug

TextFinder – Dieser Textfinder zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 zum Suchen und Ersetzen.

Parameter

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

Rückflug

TextFinder – Dieser Textfinder zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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