Class TextFinder

RicercaTesto

Trova o sostituisci il testo all'interno di un intervallo, di un foglio o di un foglio di lavoro. Può anche specificare le opzioni di ricerca.

Metodi

MetodoTipo restituitoBreve descrizione
findAll()Range[]Restituisce tutte le celle corrispondenti ai criteri di ricerca.
findNext()RangeRestituisce la cella successiva che corrisponde ai criteri di ricerca.
findPrevious()RangeRestituisce la cella precedente corrispondente ai criteri di ricerca.
getCurrentMatch()RangeRestituisce la cella corrente corrispondente ai criteri di ricerca.
ignoreDiacritics(ignoreDiacritics)TextFinderSe true, la ricerca ignora i diacritici durante la corrispondenza. In caso contrario, la ricerca corrisponde ai diacritici.
matchCase(matchCase)TextFinderSe true, configura la ricerca in modo che corrisponda esattamente alle maiuscole e alle minuscole del testo di ricerca, altrimenti la ricerca predefinita è senza distinzione tra maiuscole e minuscole.
matchEntireCell(matchEntireCell)TextFinderSe true, configura la ricerca in modo che corrisponda all'intero contenuto di una cella. In caso contrario, la ricerca predefinita è la corrispondenza parziale.
matchFormulaText(matchFormulaText)TextFinderSe true, configura la ricerca in modo da restituire le corrispondenze visualizzate nel testo della formula; in caso contrario, le celle con formule vengono considerate in base al loro valore visualizzato.
replaceAllWith(replaceText)IntegerSostituisce tutte le corrispondenze con il testo specificato.
replaceWith(replaceText)IntegerSostituisce il testo di ricerca nella cella attualmente associata con il testo specificato e restituisce il numero di occorrenze sostituite.
startFrom(startRange)TextFinderConfigura la ricerca in modo che inizi immediatamente dopo l'intervallo di celle specificato.
useRegularExpression(useRegEx)TextFinderSe true, la ricerca viene configurata in modo da interpretare la stringa di ricerca come un'espressione regolare. In caso contrario, la ricerca interpreta la stringa di ricerca come un normale testo.

Documentazione dettagliata

findAll()

Restituisce tutte le celle corrispondenti ai criteri di ricerca.

Invio

Range[]: tutte le celle corrispondenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

findNext()

Restituisce la cella successiva che corrisponde ai criteri di ricerca.

Invio

Range: la cella corrispondente successiva o null se non sono presenti corrispondenze precedenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

findPrevious()

Restituisce la cella precedente corrispondente ai criteri di ricerca.

Invio

Range: la cella corrispondente precedente o null se non sono presenti corrispondenze precedenti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getCurrentMatch()

Restituisce la cella corrente corrispondente ai criteri di ricerca.

Invio

Range: la cella di corrispondenza corrente o null se non sono presenti ulteriori corrispondenze.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

ignoreDiacritics(ignoreDiacritics)

Se true, la ricerca ignora i diacritici durante la corrispondenza. In caso contrario, la ricerca corrisponde ai diacritici. Un segno diacritico è un segno, come un accento o una cedilla, che, se scritto sopra o sotto una lettera, indica una differenza di pronuncia rispetto alla stessa lettera se non contrassegnata o contrassegnata in modo diverso.

Parametri

NomeTipoDescrizione
ignoreDiacriticsBooleanIndica se la ricerca prende in considerazione i segni diacritici.

Invio

TextFinder: questo cercatore di testo, da concatenare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

matchCase(matchCase)

Se true, configura la ricerca in modo che corrisponda esattamente alle maiuscole e alle minuscole del testo di ricerca, altrimenti la ricerca predefinita è senza distinzione tra maiuscole e minuscole.

Parametri

NomeTipoDescrizione
matchCaseBooleanIndica se la corrispondenza è sensibile alle maiuscole.

Invio

TextFinder: questo cercatore di testo, da concatenare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

matchEntireCell(matchEntireCell)

Se true, configura la ricerca in modo che corrisponda all'intero contenuto di una cella. In caso contrario, la ricerca predefinita è la corrispondenza parziale.

Parametri

NomeTipoDescrizione
matchEntireCellBooleanIndica se viene trovata una corrispondenza per l'intera cella.

Invio

TextFinder: questo cercatore di testo, da concatenare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

matchFormulaText(matchFormulaText)

Se true, configura la ricerca in modo da restituire le corrispondenze visualizzate nel testo della formula; in caso contrario, le celle con formule vengono considerate in base al loro valore visualizzato.

Parametri

NomeTipoDescrizione
matchFormulaTextBooleanIndica se la ricerca esamina il testo della formula.

Invio

TextFinder: questo cercatore di testo, da concatenare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

replaceAllWith(replaceText)

Sostituisce tutte le corrispondenze con il testo specificato. Restituisce il numero di occorrenze sostituite, che può essere diverso dal numero di celle con corrispondenza.

Parametri

NomeTipoDescrizione
replaceTextStringIl testo che sostituisce il testo nelle celle con corrispondenza.

Invio

Integer: il numero di occorrenze sostituite.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

replaceWith(replaceText)

Sostituisce il testo di ricerca nella cella attualmente associata con il testo specificato e restituisce il numero di occorrenze sostituite.

Parametri

NomeTipoDescrizione
replaceTextStringIl testo che sostituisce i contenuti nella cella attualmente associata.

Invio

Integer: il numero di occorrenze sostituite.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

startFrom(startRange)

Configura la ricerca in modo che inizi immediatamente dopo l'intervallo di celle specificato.

Parametri

NomeTipoDescrizione
startRangeRangeL'intervallo di celle dopo il quale deve iniziare la ricerca.

Invio

TextFinder: questo cercatore di testo, da concatenare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

useRegularExpression(useRegEx)

Se true, la ricerca viene configurata in modo da interpretare la stringa di ricerca come un'espressione regolare. In caso contrario, la ricerca interpreta la stringa di ricerca come un normale testo. Per maggiori dettagli su come utilizzare le espressioni regolari, consulta la pagina di assistenza Trova e sostituisci.

Parametri

NomeTipoDescrizione
useRegExBooleanIndica se interpretare la stringa di ricerca come un'espressione regolare.

Invio

TextFinder: questo cercatore di testo, da concatenare.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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