Class TextFinder

Trình tìm kiếm văn bản

Tìm hoặc thay thế văn bản trong một dải ô, trang tính hoặc bảng tính. Cũng có thể chỉ định các tuỳ chọn tìm kiếm.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
findAll()Range[]Trả về tất cả các ô khớp với tiêu chí tìm kiếm.
findNext()RangeTrả về ô tiếp theo khớp với tiêu chí tìm kiếm.
findPrevious()RangeTrả về ô trước đó khớp với tiêu chí tìm kiếm.
getCurrentMatch()RangeTrả về ô hiện tại khớp với tiêu chí tìm kiếm.
ignoreDiacritics(ignoreDiacritics)TextFinderNếu true, hãy định cấu hình tính năng tìm kiếm để bỏ qua dấu phụ trong khi so khớp; nếu không, tính năng tìm kiếm sẽ so khớp dấu phụ.
matchCase(matchCase)TextFinderNếu true, hãy định cấu hình tính năng tìm kiếm để khớp chính xác với chữ hoa chữ thường của văn bản tìm kiếm, nếu không, tính năng tìm kiếm sẽ mặc định khớp không phân biệt chữ hoa chữ thường.
matchEntireCell(matchEntireCell)TextFinderNếu true, hãy định cấu hình tìm kiếm để khớp toàn bộ nội dung của một ô; nếu không, tìm kiếm sẽ mặc định là khớp một phần.
matchFormulaText(matchFormulaText)TextFinderNếu true, hãy định cấu hình tìm kiếm để trả về các kết quả trùng khớp xuất hiện trong văn bản công thức; nếu không, các ô có công thức sẽ được xem xét dựa trên giá trị hiển thị của chúng.
replaceAllWith(replaceText)IntegerThay thế tất cả kết quả trùng khớp bằng văn bản đã chỉ định.
replaceWith(replaceText)IntegerThay thế văn bản tìm kiếm trong ô hiện được so khớp bằng văn bản đã chỉ định và trả về số lần xuất hiện được thay thế.
startFrom(startRange)TextFinderĐịnh cấu hình tìm kiếm để bắt đầu tìm kiếm ngay sau dải ô được chỉ định.
useRegularExpression(useRegEx)TextFinderNếu true, hãy định cấu hình tính năng tìm kiếm để diễn giải chuỗi tìm kiếm dưới dạng biểu thức chính quy; nếu không, tính năng tìm kiếm sẽ diễn giải chuỗi tìm kiếm dưới dạng văn bản thông thường.

Tài liệu chi tiết

findAll()

Trả về tất cả các ô khớp với tiêu chí tìm kiếm.

Cầu thủ trả bóng

Range[] – Tất cả các ô trùng khớp.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

findNext()

Trả về ô tiếp theo khớp với tiêu chí tìm kiếm.

Cầu thủ trả bóng

Range – Ô khớp tiếp theo hoặc null nếu không có ô khớp nào trước đó.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

findPrevious()

Trả về ô trước đó khớp với tiêu chí tìm kiếm.

Cầu thủ trả bóng

Range – Ô khớp trước đó hoặc null nếu không có ô khớp trước đó.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getCurrentMatch()

Trả về ô hiện tại khớp với tiêu chí tìm kiếm.

Cầu thủ trả bóng

Range – Ô trùng khớp hiện tại hoặc null nếu không có ô nào trùng khớp khác.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

" id="ignorediacriticsignorediacritics" tabindex="-1"> ignoreDiacritics(ignoreDiacritics)

Nếu true, hãy định cấu hình tính năng tìm kiếm để bỏ qua dấu phụ trong khi so khớp; nếu không, tính năng tìm kiếm sẽ so khớp dấu phụ. Dấu phụ là một dấu, chẳng hạn như dấu trọng âm hoặc dấu cedilla, khi được viết phía trên hoặc phía dưới một chữ cái, cho biết sự khác biệt về cách phát âm của cùng một chữ cái khi không được đánh dấu hoặc được đánh dấu theo cách khác.

Tham số

TênLoạiMô tả
ignoreDiacriticsBooleanLiệu tính năng tìm kiếm có xem xét các dấu phụ hay không.

Cầu thủ trả bóng

TextFinder – Trình tìm kiếm văn bản này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

matchCase(matchCase)

Nếu true, hãy định cấu hình tính năng tìm kiếm để khớp chính xác với chữ hoa chữ thường của văn bản tìm kiếm, nếu không, tính năng tìm kiếm sẽ mặc định khớp không phân biệt chữ hoa chữ thường.

Tham số

TênLoạiMô tả
matchCaseBooleanLiệu kết quả so khớp có phân biệt chữ hoa chữ thường hay không.

Cầu thủ trả bóng

TextFinder – Trình tìm kiếm văn bản này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

matchEntireCell(matchEntireCell)

Nếu true, hãy định cấu hình tìm kiếm để khớp toàn bộ nội dung của một ô; nếu không, tìm kiếm sẽ mặc định là khớp một phần.

Tham số

TênLoạiMô tả
matchEntireCellBooleanLiệu toàn bộ ô có được so khớp hay không.

Cầu thủ trả bóng

TextFinder – Trình tìm kiếm văn bản này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

matchFormulaText(matchFormulaText)

Nếu true, hãy định cấu hình tìm kiếm để trả về các kết quả trùng khớp xuất hiện trong văn bản công thức; nếu không, các ô có công thức sẽ được xem xét dựa trên giá trị hiển thị của chúng.

Tham số

TênLoạiMô tả
matchFormulaTextBooleanLiệu tính năng tìm kiếm có kiểm tra văn bản công thức hay không.

Cầu thủ trả bóng

TextFinder – Trình tìm kiếm văn bản này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

replaceAllWith(replaceText)

Thay thế tất cả kết quả trùng khớp bằng văn bản đã chỉ định. Trả về số lần xuất hiện được thay thế, số này có thể khác với số ô khớp.

Tham số

TênLoạiMô tả
replaceTextStringVăn bản thay thế văn bản trong các ô khớp.

Cầu thủ trả bóng

Integer – Số lần xuất hiện được thay thế.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

replaceWith(replaceText)

Thay thế văn bản tìm kiếm trong ô hiện được so khớp bằng văn bản đã chỉ định và trả về số lần xuất hiện được thay thế.

Tham số

TênLoạiMô tả
replaceTextStringVăn bản thay thế nội dung trong ô hiện đang được so khớp.

Cầu thủ trả bóng

Integer – Số lần xuất hiện được thay thế.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

startFrom(startRange)

Định cấu hình tìm kiếm để bắt đầu tìm kiếm ngay sau dải ô được chỉ định.

Tham số

TênLoạiMô tả
startRangeRangePhạm vi ô mà sau đó quá trình tìm kiếm sẽ bắt đầu.

Cầu thủ trả bóng

TextFinder – Trình tìm kiếm văn bản này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

useRegularExpression(useRegEx)

Nếu true, hãy định cấu hình tính năng tìm kiếm để diễn giải chuỗi tìm kiếm dưới dạng biểu thức chính quy; nếu không, tính năng tìm kiếm sẽ diễn giải chuỗi tìm kiếm dưới dạng văn bản thông thường. Để biết thêm thông tin chi tiết về cách sử dụng biểu thức chính quy, hãy tham khảo trang hỗ trợ về tính năng Tìm và thay thế.

Tham số

TênLoạiMô tả
useRegExBooleanLiệu có diễn giải chuỗi tìm kiếm dưới dạng biểu thức chính quy hay không.

Cầu thủ trả bóng

TextFinder – Trình tìm kiếm văn bản này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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