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 , akan mengonfigurasi penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak,
penelusuran akan cocok dengan diakritik. |
matchCase(matchCase) | TextFinder | Jika true , akan mengonfigurasi penelusuran agar sama persis dengan kapitalisasi teks penelusuran. Jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil. |
matchEntireCell(matchEntireCell) | TextFinder | Jika true , akan mengonfigurasi penelusuran agar cocok dengan seluruh konten sel; jika tidak, penelusuran akan ditetapkan secara default ke pencocokan sebagian. |
matchFormulaText(matchFormulaText) | TextFinder | Jika true , mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula;
jika tidak, sel dengan formula akan dipertimbangkan berdasarkan nilai yang ditampilkan. |
replaceAllWith(replaceText) | Integer | Mengganti semua kecocokan dengan teks yang ditentukan. |
replaceWith(replaceText) | Integer | Mengganti teks penelusuran dalam sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti. |
startFrom(startRange) | TextFinder | Mengonfigurasi penelusuran untuk memulai penelusuran tepat setelah rentang sel yang ditentukan. |
useRegularExpression(useRegEx) | TextFinder | Jika true , akan mengonfigurasi penelusuran untuk 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 yang cocok berikutnya, 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
, akan mengonfigurasi penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak,
penelusuran akan cocok dengan diakritik. Diakritik adalah tanda, seperti aksen atau cedilla, yang jika
ditulis di atas atau di bawah huruf menunjukkan perbedaan pengucapan dari huruf yang sama
jika tidak ditandai atau ditandai secara berbeda.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
ignoreDiacritics | Boolean | Apakah penelusuran dianggap sebagai diakritik. |
Return
TextFinder
— Pencari teks ini, untuk perantaian.
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
, akan mengonfigurasi penelusuran agar sama persis dengan kapitalisasi teks penelusuran. Jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
matchCase | Boolean | Apakah pencocokan peka huruf besar/kecil. |
Return
TextFinder
— Pencari teks ini, untuk perantaian.
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
, akan mengonfigurasi penelusuran agar cocok dengan seluruh konten sel; jika tidak, penelusuran akan ditetapkan secara default ke pencocokan sebagian.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
matchEntireCell | Boolean | Apakah seluruh sel dicocokkan. |
Return
TextFinder
— Pencari teks ini, untuk perantaian.
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
, mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula;
jika tidak, sel dengan formula akan dipertimbangkan berdasarkan nilai yang ditampilkan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
matchFormulaText | Boolean | Apakah penelusuran memeriksa teks formula. |
Return
TextFinder
— Pencari teks ini, untuk perantaian.
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)
Mengganti semua kecocokan dengan teks yang ditentukan. Menampilkan jumlah kemunculan yang diganti, yang mungkin berbeda dari jumlah sel yang cocok.
Parameter
Nama | 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)
Mengganti teks penelusuran dalam sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
replaceText | String | Teks yang menggantikan konten dalam sel yang saat ini 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
startFrom(startRange)
Mengonfigurasi penelusuran untuk memulai penelusuran tepat setelah rentang sel yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
startRange | Range | Rentang sel yang digunakan setelah penelusuran akan dimulai. |
Return
TextFinder
— Pencari teks ini, untuk perantaian.
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
, akan mengonfigurasi penelusuran untuk 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 dukungan cari dan ganti.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
useRegEx | Boolean | Apakah akan menafsirkan string penelusuran sebagai ekspresi reguler. |
Return
TextFinder
— Pencari teks ini, untuk perantaian.
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