Trovare o sostituire testo all'interno di un intervallo, un foglio o un foglio di lavoro. Puoi anche specificare le opzioni di ricerca.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
find | Range[] | Restituisce tutte le celle che corrispondono ai criteri di ricerca. |
find | Range | Restituisce la cella successiva che corrisponde ai criteri di ricerca. |
find | Range | Restituisce la cella precedente che corrisponde ai criteri di ricerca. |
get | Range | Restituisce la cella corrente che corrisponde ai criteri di ricerca. |
ignore | Text | Se true, la ricerca viene configurata in modo da ignorare i segni diacritici durante la corrispondenza; in caso contrario, la
ricerca corrisponde ai segni diacritici. |
match | Text | Se true, configura la ricerca in modo che corrisponda esattamente alla distinzione tra maiuscole e minuscole del testo di ricerca, altrimenti la ricerca viene impostata per impostazione predefinita sulla corrispondenza senza distinzione tra maiuscole e minuscole. |
match | Text | Se true, configura la ricerca in modo che corrisponda all'intero contenuto di una cella; in caso contrario, la
ricerca viene impostata per impostazione predefinita sulla corrispondenza parziale. |
match | Text | Se true, configura la ricerca in modo che restituisca le corrispondenze che appaiono all'interno del testo della formula;
altrimenti le celle con formule vengono prese in considerazione in base al loro valore visualizzato. |
replace | Integer | Sostituisce tutte le corrispondenze con il testo specificato. |
replace | Integer | Sostituisce il testo di ricerca nella cella attualmente corrispondente con il testo specificato e restituisce il numero di occorrenze sostituite. |
start | Text | Configura la ricerca in modo che inizi immediatamente dopo l'intervallo di celle specificato. |
use | Text | Se true, configura la ricerca in modo che interpreti la stringa di ricerca come un'espressione regolare;
altrimenti la ricerca interpreta la stringa di ricerca come testo normale. |
Documentazione dettagliata
findAll()
Restituisce tutte le celle che corrispondono ai criteri di ricerca.
Indietro
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.
Indietro
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.
Indietro
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.
Indietro
Range: la cella corrispondente corrente oppure 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, la ricerca viene configurata 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 di pronuncia rispetto alla stessa lettera
quando non è contrassegnata o è contrassegnata in modo diverso.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
ignore | Boolean | Indica se la ricerca considera i segni diacritici. |
Indietro
TextFinder: questo strumento di ricerca del testo, per il concatenamento.
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 alla distinzione tra maiuscole e minuscole del testo di ricerca, altrimenti la ricerca viene impostata per impostazione predefinita sulla corrispondenza senza distinzione tra maiuscole e minuscole.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
match | Boolean | Indica se la corrispondenza è sensibile alle maiuscole. |
Indietro
TextFinder: questo strumento di ricerca del testo, per il concatenamento.
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 viene impostata per impostazione predefinita sulla corrispondenza parziale.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
match | Boolean | Indica se l'intera cella corrisponde. |
Indietro
TextFinder: questo strumento di ricerca del testo, per il concatenamento.
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 che appaiono all'interno del testo della formula;
altrimenti le celle con formule vengono prese in considerazione in base al loro valore visualizzato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
match | Boolean | Indica se la ricerca esamina il testo della formula. |
Indietro
TextFinder: questo strumento di ricerca del testo, per il concatenamento.
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 |
|---|---|---|
replace | String | Il testo che sostituisce il testo nelle celle corrispondenti. |
Indietro
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 corrispondente con il testo specificato e restituisce il numero di occorrenze sostituite.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
replace | String | Il testo che sostituisce i contenuti nella cella attualmente corrispondente. |
Indietro
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
| Nome | Tipo | Descrizione |
|---|---|---|
start | Range | L'intervallo di celle dopo il quale deve iniziare la ricerca. |
Indietro
TextFinder: questo strumento di ricerca del testo, per il concatenamento.
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 interpreti la stringa di ricerca come un'espressione regolare;
altrimenti la ricerca interpreta la stringa di ricerca come testo normale. Per maggiori dettagli su come
utilizzare le espressioni regolari, consulta la
pagina di assistenza Trova e sostituisci.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
use | Boolean | Indica se interpretare la stringa di ricerca come espressione regolare. |
Indietro
TextFinder: questo strumento di ricerca del testo, per il concatenamento.
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