หน้านี้ได้รับการแปลโดย Cloud Translation API

Class TextFinder

ค้นหาหรือแทนที่ข้อความภายในช่วง ชีต หรือสเปรดชีต นอกจากนี้ยังระบุตัวเลือกการค้นหาได้ด้วย

วิธีการ

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`findAll()`	`Range[]`	แสดงผลเซลล์ทั้งหมดที่ตรงกับเกณฑ์การค้นหา
`findNext()`	`Range`	แสดงผลเซลล์ถัดไปที่ตรงกับเกณฑ์การค้นหา
`findPrevious()`	`Range`	แสดงผลเซลล์ก่อนหน้าที่ตรงกับเกณฑ์การค้นหา
`getCurrentMatch()`	`Range`	แสดงผลเซลล์ปัจจุบันที่ตรงกับเกณฑ์การค้นหา
`ignoreDiacritics(ignoreDiacritics)`	`TextFinder`	หากเป็น `true` จะกำหนดค่าการค้นหาให้ละเว้นเครื่องหมายออกเสียงขณะจับคู่ ไม่เช่นนั้นการค้นหาจะตรงกับเครื่องหมายกำกับการออกเสียง
`matchCase(matchCase)`	`TextFinder`	หากเป็น `true` ให้กําหนดค่าการค้นหาให้ตรงกับตัวพิมพ์ของข้อความค้นหาทุกประการ ไม่เช่นนั้น การค้นหาจะใช้ค่าเริ่มต้นเป็นการจับคู่ที่ไม่คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
`matchEntireCell(matchEntireCell)`	`TextFinder`	หากเป็น `true` จะกำหนดค่าการค้นหาให้ตรงกับเนื้อหาทั้งหมดของเซลล์ มิฉะนั้นการค้นหาจะใช้การจับคู่บางส่วนเป็นค่าเริ่มต้น
`matchFormulaText(matchFormulaText)`	`TextFinder`	หากเป็น `true` ให้กำหนดค่าการค้นหาให้แสดงผลลัพธ์ที่ตรงกันที่ปรากฏในข้อความสูตร ไม่เช่นนั้น ระบบจะพิจารณาเซลล์ที่มีสูตรตามค่าที่แสดง
`replaceAllWith(replaceText)`	`Integer`	จะแทนที่รายการที่ตรงกันทั้งหมดด้วยข้อความที่ระบุ
`replaceWith(replaceText)`	`Integer`	แทนที่ข้อความค้นหาในเซลล์ที่ตรงกันในปัจจุบันด้วยข้อความที่ระบุ และแสดงผลจำนวนครั้งของรายการที่แทนที่
`startFrom(startRange)`	`TextFinder`	กําหนดค่าการค้นหาเพื่อเริ่มค้นหาทันทีหลังจากช่วงเซลล์ที่ระบุ
`useRegularExpression(useRegEx)`	`TextFinder`	หากเป็น `true` จะกำหนดค่าการค้นหาให้แปลความหมายสตริงการค้นหาเป็นนิพจน์ทั่วไป มิฉะนั้นการค้นหาจะตีความสตริงการค้นหาเป็นข้อความปกติ

เอกสารประกอบโดยละเอียด

`findAll()`

แสดงผลเซลล์ทั้งหมดที่ตรงกับเกณฑ์การค้นหา

รีเทิร์น

Range[] — เซลล์ที่ตรงกันทั้งหมด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`findNext()`

แสดงผลเซลล์ถัดไปที่ตรงกับเกณฑ์การค้นหา

รีเทิร์น

Range — เซลล์ถัดไปที่ตรงกัน หรือ null หากไม่มีรายการที่ตรงกันก่อนหน้า

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`findPrevious()`

แสดงผลเซลล์ก่อนหน้าที่ตรงกับเกณฑ์การค้นหา

รีเทิร์น

Range — เซลล์ที่ตรงกันก่อนหน้า หรือ null หากไม่มีรายการที่ตรงกันก่อนหน้า

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCurrentMatch()`

แสดงผลเซลล์ปัจจุบันที่ตรงกับเกณฑ์การค้นหา

รีเทิร์น

Range — เซลล์ที่ตรงกันปัจจุบัน หรือ null หากไม่มีรายการที่ตรงกันเพิ่มเติม

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`ignoreDiacritics(ignoreDiacritics)`

หากเป็น true จะกำหนดค่าการค้นหาให้ละเว้นเครื่องหมายออกเสียงขณะจับคู่ ไม่เช่นนั้นการค้นหาจะตรงกับเครื่องหมายกำกับการออกเสียง เครื่องหมายการออกเสียง เช่น เครื่องหมายกำกับการออกเสียงหรือซิดิลลา ซึ่งเมื่อเขียนอยู่ด้านบนหรือด้านล่างตัวอักษรจะบ่งบอกถึงความแตกต่างในการออกเสียงจากตัวอักษรเดียวกัน เมื่อไม่ได้ทำเครื่องหมายหรือทำเครื่องหมายต่างออกไป

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`ignoreDiacritics`	`Boolean`	การค้นหาจะพิจารณาเครื่องหมายออกเสียงหรือไม่

รีเทิร์น

TextFinder — เครื่องมือค้นหาข้อความนี้สำหรับการทำเชน

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`matchCase(matchCase)`

หากเป็น true ให้กําหนดค่าการค้นหาให้ตรงกับตัวพิมพ์ของข้อความค้นหาทุกประการ ไม่เช่นนั้น การค้นหาจะใช้ค่าเริ่มต้นเป็นการจับคู่ที่ไม่คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`matchCase`	`Boolean`	จับคู่ตรงตามตัวพิมพ์ใหญ่-เล็กหรือไม่

รีเทิร์น

TextFinder — เครื่องมือค้นหาข้อความนี้สำหรับการทำเชน

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`matchEntireCell(matchEntireCell)`

หากเป็น true จะกำหนดค่าการค้นหาให้ตรงกับเนื้อหาทั้งหมดของเซลล์ มิฉะนั้นการค้นหาจะใช้การจับคู่บางส่วนเป็นค่าเริ่มต้น

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`matchEntireCell`	`Boolean`	ดูว่าทั้งเซลล์มีการจับคู่หรือไม่

รีเทิร์น

TextFinder — เครื่องมือค้นหาข้อความนี้สำหรับการทำเชน

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`matchFormulaText(matchFormulaText)`

หากเป็น true ให้กำหนดค่าการค้นหาให้แสดงผลลัพธ์ที่ตรงกันที่ปรากฏในข้อความสูตร ไม่เช่นนั้น ระบบจะพิจารณาเซลล์ที่มีสูตรตามค่าที่แสดง

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`matchFormulaText`	`Boolean`	การค้นหามีการตรวจสอบข้อความสูตรหรือไม่

รีเทิร์น

TextFinder — เครื่องมือค้นหาข้อความนี้สำหรับการทำเชน

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`replaceAllWith(replaceText)`

จะแทนที่รายการที่ตรงกันทั้งหมดด้วยข้อความที่ระบุ แสดงผลจำนวนรายการที่ถูกแทนที่ ซึ่งอาจต่างจากจำนวนของเซลล์ที่ตรงกัน

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`replaceText`	`String`	ข้อความที่แทนที่ข้อความในเซลล์ที่ตรงกัน

รีเทิร์น

Integer — จำนวนรายการที่แทนที่

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`replaceWith(replaceText)`

แทนที่ข้อความค้นหาในเซลล์ที่ตรงกันในปัจจุบันด้วยข้อความที่ระบุ และแสดงผลจำนวนครั้งของรายการที่แทนที่

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`replaceText`	`String`	ข้อความที่แทนที่เนื้อหาในเซลล์ที่ตรงกันในปัจจุบัน

รีเทิร์น

Integer — จำนวนรายการที่แทนที่

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`startFrom(startRange)`

กําหนดค่าการค้นหาเพื่อเริ่มค้นหาทันทีหลังจากช่วงเซลล์ที่ระบุ

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`startRange`	`Range`	ช่วงของเซลล์ที่การค้นหาจะเริ่มขึ้น

รีเทิร์น

TextFinder — เครื่องมือค้นหาข้อความนี้สำหรับการทำเชน

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`useRegularExpression(useRegEx)`

หากเป็น true จะกำหนดค่าการค้นหาให้แปลความหมายสตริงการค้นหาเป็นนิพจน์ทั่วไป มิฉะนั้นการค้นหาจะตีความสตริงการค้นหาเป็นข้อความปกติ สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการใช้นิพจน์ทั่วไป โปรดดูที่ หน้าค้นหาและแทนที่การสนับสนุน

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`useRegEx`	`Boolean`	ต้องการตีความสตริงการค้นหาเป็นนิพจน์ทั่วไปหรือไม่

รีเทิร์น

TextFinder — เครื่องมือค้นหาข้อความนี้สำหรับการทำเชน

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets