หน้านี้ได้รับการแปลโดย 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` ระบบจะกําหนดค่าการค้นหาให้ตีความสตริงการค้นหาเป็นนิพจน์ทั่วไป หากไม่เป็น `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 ระบบจะกําหนดค่าการค้นหาให้ละเว้นเครื่องหมายเสริมในขณะที่จับคู่ มิเช่นนั้นการค้นหาจะจับคู่เครื่องหมายเสริม เครื่องหมายแสดงการออกเสียงคือเครื่องหมาย เช่น เครื่องหมายกำกับการออกเสียงหรือเครื่องหมายซีดิลลา ซึ่งเมื่อเขียนไว้เหนือหรือใต้ตัวอักษร แสดงถึงความแตกต่างในการออกเสียงจากตัวอักษรเดียวกันเมื่อไม่มีเครื่องหมายหรือมีเครื่องหมายอื่น

พารามิเตอร์

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

รีเทิร์น

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

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

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

`matchCase(matchCase)`

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`matchCase`	`Boolean`	ระบุว่าการจับคู่จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่หรือไม่

รีเทิร์น

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

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

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

`matchEntireCell(matchEntireCell)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

`matchFormulaText(matchFormulaText)`

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`matchFormulaText`	`Boolean`	ระบุว่าการค้นหาจะตรวจสอบข้อความสูตรหรือไม่

รีเทิร์น

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

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

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

`replaceAllWith(replaceText)`

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

พารามิเตอร์

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

รีเทิร์น

Integer — จํานวนครั้งที่มีการแทนที่

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

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

`replaceWith(replaceText)`

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

พารามิเตอร์

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

รีเทิร์น

Integer — จํานวนครั้งที่มีการแทนที่

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

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

`startFrom(startRange)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

`useRegularExpression(useRegEx)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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