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 หากไม่มีรายการที่ตรงกันก่อนหน้า

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

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

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

findPrevious()

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

รีเทิร์น

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

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

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

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

getCurrentMatch()

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

รีเทิร์น

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

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

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

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

ignoreDiacritics(ignoreDiacritics)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

matchCase(matchCase)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

matchEntireCell(matchEntireCell)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

matchFormulaText(matchFormulaText)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

replaceAllWith(replaceText)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

replaceWith(replaceText)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

startFrom(startRange)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

useRegularExpression(useRegEx)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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