Halaman ini diterjemahkan oleh Cloud Translation API.

Class TextFinder

Menemukan 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`, konfigurasikan penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan mencocokkan diakritik.
`matchCase(matchCase)`	`TextFinder`	Jika `true`, konfigurasikan penelusuran agar cocok persis dengan huruf besar/kecil teks penelusuran. Jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil.
`matchEntireCell(matchEntireCell)`	`TextFinder`	Jika `true`, 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 di sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti.
`startFrom(startRange)`	`TextFinder`	Mengonfigurasi penelusuran untuk mulai menelusuri segera setelah rentang sel yang ditentukan.
`useRegularExpression(useRegEx)`	`TextFinder`	Jika `true`, konfigurasikan 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.

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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, konfigurasikan penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan mencocokkan 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 mempertimbangkan diakritik.

Pulang pergi

TextFinder — Pencari teks ini, untuk penyambungan.

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, konfigurasikan penelusuran agar cocok persis dengan huruf besar/kecil 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.

Pulang pergi

TextFinder — Pencari teks ini, untuk penyambungan.

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, 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 cocok.

Pulang pergi

TextFinder — Pencari teks ini, untuk penyambungan.

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.

Pulang pergi

TextFinder — Pencari teks ini, untuk penyambungan.

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 dengan jumlah sel yang cocok.

Parameter

Nama	Jenis	Deskripsi
`replaceText`	`String`	Teks yang menggantikan teks di sel yang cocok.

Pulang pergi

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 di 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 di sel yang saat ini cocok.

Pulang pergi

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 segera setelah rentang sel yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`startRange`	`Range`	Rentang sel tempat penelusuran akan dimulai.

Pulang pergi

TextFinder — Pencari teks ini, untuk penyambungan.

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, konfigurasikan penelusuran untuk menafsirkan string penelusuran sebagai ekspresi reguler; jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal. Untuk mengetahui detail selengkapnya tentang cara menggunakan ekspresi reguler, lihat halaman Dukungan temukan dan ganti.

Parameter

Nama	Jenis	Deskripsi
`useRegEx`	`Boolean`	Apakah akan menafsirkan string penelusuran sebagai ekspresi reguler.

Pulang pergi

TextFinder — Pencari teks ini, untuk penyambungan.

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