Trova o sostituisci testo all'interno di un intervallo, di un foglio o di un foglio di lavoro. Puoi anche specificare opzioni di ricerca.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
findAll() | Range[] | Restituisce tutte le celle che corrispondono ai criteri di ricerca. |
findNext() | Range | Restituisce la cella successiva che corrisponde ai criteri di ricerca. |
findPrevious() | Range | Restituisce la cella precedente che corrisponde ai criteri di ricerca. |
getCurrentMatch() | Range | Restituisce la cella corrente che corrisponde ai criteri di ricerca. |
ignoreDiacritics(ignoreDiacritics) | TextFinder | Se true, configura la ricerca in modo da ignorare i segni diacritici durante la corrispondenza; in caso contrario, la ricerca corrisponde ai segni diacritici. |
matchCase(matchCase) | TextFinder | Se true, configura la ricerca in modo che corrisponda esattamente alle maiuscole del testo della ricerca, altrimenti la ricerca utilizza per impostazione predefinita la corrispondenza senza distinzione tra maiuscole e minuscole. |
matchEntireCell(matchEntireCell) | TextFinder | Se true, configura la ricerca in modo che corrisponda all'intero contenuto di una cella; in caso contrario, per impostazione predefinita la ricerca utilizza la corrispondenza parziale. |
matchFormulaText(matchFormulaText) | TextFinder | Se true, configura la ricerca in modo che restituisca le corrispondenze visualizzate nel testo della formula. In caso contrario, le celle con formule vengono considerate in base al valore visualizzato. |
replaceAllWith(replaceText) | Integer | Sostituisce tutte le corrispondenze con il testo specificato. |
replaceWith(replaceText) | Integer | Sostituisce il testo della ricerca nella cella attualmente corrispondente con il testo specificato e restituisce il numero di occorrenze sostituite. |
startFrom(startRange) | TextFinder | Configura la ricerca in modo da iniziare la ricerca immediatamente dopo l'intervallo di celle specificato. |
useRegularExpression(useRegEx) | TextFinder | Se true, configura la ricerca in modo che interpreta la stringa di ricerca come un'espressione regolare; in caso contrario la ricerca interpreta la stringa di ricerca come testo normale. |
Documentazione dettagliata
findAll()
Restituisce tutte le celle che corrispondono ai criteri di ricerca.
Ritorni
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.
Ritorni
Range: la cella corrispondente successiva o null se non ci sono 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 che corrisponde ai criteri di ricerca.
Ritorni
Range: la cella corrispondente precedente o null se non ci sono 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 che corrisponde ai criteri di ricerca.
Ritorni
Range: la cella corrispondente corrente o null se non ci sono altre 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, configura la ricerca in modo da ignorare i segni diacritici durante la corrispondenza; in caso contrario, la ricerca corrisponde ai segni diacritici. Un segno diacritico è un segno, ad esempio un accento o una cediglia, che, se scritto sopra o sotto una lettera, indica una differenza nella pronuncia della stessa lettera quando non viene contrassegnata o marcata in modo diverso.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
ignoreDiacritics | Boolean | Indica se la ricerca considera segni diacritici. |
Ritorni
TextFinder - Questo strumento per la ricerca di testi, per la concatenazione.
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 del testo della ricerca, altrimenti la ricerca utilizza per impostazione predefinita la corrispondenza senza distinzione tra maiuscole e minuscole.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
matchCase | Boolean | Indica se la corrispondenza è sensibile alle maiuscole. |
Ritorni
TextFinder - Questo strumento per la ricerca di testi, per la concatenazione.
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, per impostazione predefinita la ricerca utilizza la corrispondenza parziale.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
matchEntireCell | Boolean | Indica se corrisponde all'intera cella. |
Ritorni
TextFinder - Questo strumento per la ricerca di testi, per la concatenazione.
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 che restituisca le corrispondenze visualizzate nel testo della formula. In caso contrario, le celle con formule vengono considerate in base al valore visualizzato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
matchFormulaText | Boolean | Indica se la ricerca esamina il testo della formula. |
Ritorni
TextFinder - Questo strumento per la ricerca di testi, per la concatenazione.
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 potrebbe essere diverso dal numero di celle corrispondenti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
replaceText | String | Il testo che sostituisce il testo nelle celle con corrispondenze. |
Ritorni
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 della ricerca nella cella attualmente corrispondente con il testo specificato e restituisce il numero di occorrenze sostituite.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
replaceText | String | Il testo che sostituisce i contenuti nella cella attualmente corrispondente. |
Ritorni
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 da iniziare la ricerca immediatamente dopo l'intervallo di celle specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
startRange | Range | L'intervallo di celle dopo il quale deve iniziare la ricerca. |
Ritorni
TextFinder - Questo strumento per la ricerca di testi, per la concatenazione.
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, configura la ricerca in modo che interpreta la stringa di ricerca come un'espressione regolare; in caso contrario la ricerca interpreta la stringa di ricerca come testo normale. Per ulteriori dettagli sull'utilizzo delle espressioni regolari, consulta la
pagina di assistenza Trova e sostituisci.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
useRegEx | Boolean | Indica se interpretare la stringa di ricerca come un'espressione regolare. |
Ritorni
TextFinder - Questo strumento per la ricerca di testi, per la concatenazione.
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