Mencari atau mengganti teks dalam rentang, sheet, atau spreadsheet. Juga dapat menentukan opsi penelusuran.
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
findAll() | Range[] | Menampilkan semua sel yang cocok dengan kriteria penelusuran. |
findNext() | Range | Menampilkan sel berikutnya yang cocok dengan kriteria penelusuran. |
findPrevious() | Range | Menampilkan sel sebelumnya yang cocok dengan kriteria penelusuran. |
getCurrentMatch() | Range | Menampilkan sel saat ini yang cocok dengan kriteria penelusuran. |
ignoreDiacritics(ignoreDiacritics) | TextFinder | Jika true, konfigurasi penelusuran akan mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan cocok dengan diakritik. |
matchCase(matchCase) | TextFinder | Jika true, konfigurasi penelusuran akan dicocokkan dengan kasus teks penelusuran secara tepat, jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil. |
matchEntireCell(matchEntireCell) | TextFinder | Jika true, konfigurasi penelusuran akan dicocokkan dengan seluruh konten sel; jika tidak, penelusuran akan ditetapkan secara default ke pencocokan parsial. |
matchFormulaText(matchFormulaText) | TextFinder | Jika true, akan mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula; jika tidak, sel dengan formula dipertimbangkan berdasarkan nilai yang ditampilkan. |
replaceAllWith(replaceText) | Integer | Menggantikan semua kecocokan dengan teks yang ditentukan. |
replaceWith(replaceText) | Integer | Menggantikan teks penelusuran dalam sel yang cocok saat ini dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti. |
startFrom(startRange) | TextFinder | Mengonfigurasi penelusuran untuk mulai menelusuri tepat setelah rentang sel yang ditentukan. |
useRegularExpression(useRegEx) | TextFinder | Jika true, konfigurasi penelusuran akan menafsirkan string penelusuran sebagai ekspresi reguler;
jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal. |
Dokumentasi mendetail
findAll()
Menampilkan semua sel yang cocok dengan kriteria penelusuran.
Return
Range[] — Semua sel yang cocok.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Menampilkan sel berikutnya yang cocok dengan kriteria penelusuran.
Return
Range — Sel berikutnya yang cocok, atau null jika tidak ada kecocokan sebelumnya.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Menampilkan sel sebelumnya yang cocok dengan kriteria penelusuran.
Return
Range — Sel yang cocok sebelumnya, atau null jika tidak ada kecocokan sebelumnya.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Menampilkan sel saat ini yang cocok dengan kriteria penelusuran.
Return
Range — Sel yang cocok saat ini, atau null jika tidak ada kecocokan lebih lanjut.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
Jika true, konfigurasi penelusuran akan mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan cocok dengan diakritik. Diakritik adalah sebuah tanda, seperti aksen atau cedilla, yang
jika ditulis di atas atau di bawah huruf menunjukkan perbedaan pengucapan dari huruf yang sama
saat tidak ditandai atau ditandai secara berbeda.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
ignoreDiacritics | Boolean | Apakah penelusuran tersebut mempertimbangkan diakritik. |
Return
TextFinder — Pencari teks ini, untuk rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
Jika true, konfigurasi penelusuran akan dicocokkan dengan kasus teks penelusuran secara tepat, jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
matchCase | Boolean | Apakah pencocokan peka huruf besar/kecil. |
Return
TextFinder — Pencari teks ini, untuk rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
Jika true, konfigurasi penelusuran akan dicocokkan dengan seluruh konten sel; jika tidak, penelusuran akan ditetapkan secara default ke pencocokan parsial.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
matchEntireCell | Boolean | Apakah seluruh sel dicocokkan. |
Return
TextFinder — Pencari teks ini, untuk rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
Jika true, akan mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula; jika tidak, sel dengan formula dipertimbangkan berdasarkan nilai yang ditampilkan.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
matchFormulaText | Boolean | Apakah penelusuran memeriksa teks formula. |
Return
TextFinder — Pencari teks ini, untuk rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Menggantikan semua kecocokan dengan teks yang ditentukan. Menampilkan jumlah kemunculan yang diganti, yang mungkin berbeda dari jumlah sel yang cocok.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
replaceText | String | Teks yang menggantikan teks dalam sel yang cocok. |
Return
Integer — Jumlah kemunculan yang diganti.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Menggantikan teks penelusuran dalam sel yang cocok saat ini dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
replaceText | String | Teks yang menggantikan konten dalam sel yang cocok saat ini. |
Return
Integer — Jumlah kemunculan yang diganti.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Mengonfigurasi penelusuran untuk mulai menelusuri tepat setelah rentang sel yang ditentukan.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
startRange | Range | Rentang sel sebelum penelusuran dimulai. |
Return
TextFinder — Pencari teks ini, untuk rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
Jika true, konfigurasi penelusuran akan menafsirkan string penelusuran sebagai ekspresi reguler;
jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal. Untuk detail selengkapnya tentang cara
menggunakan ekspresi reguler, lihat
halaman Menemukan dan mengganti dukungan.
Parameter
| Name | Jenis | Deskripsi |
|---|---|---|
useRegEx | Boolean | Apakah menginterpretasikan string penelusuran sebagai ekspresi reguler. |
Return
TextFinder — Pencari teks ini, untuk rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets