Class TextFinder

TextFinder

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ứcKiểu dữ liệu trả vềMô tả ngắn
findAll()Range[]Trả về tất 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 là true, hãy định cấu hình lượt tìm kiếm để bỏ qua các dấu phụ trong khi so khớp; nếu không, kết quả tìm kiếm sẽ khớp với các dấu phụ.
matchCase(matchCase)TextFinderNếu là true, hãy định cấu hình cụm từ tìm kiếm cho khớp chính xác với trường hợp của văn bản tìm kiếm, nếu không, chế độ tìm kiếm sẽ mặc định chuyển thành kiểu khớp không phân biệt chữ hoa chữ thường.
matchEntireCell(matchEntireCell)TextFinderNếu là true, hãy định cấu hình lệnh tìm kiếm để khớp với toàn bộ nội dung của một ô; nếu không, chế độ tìm kiếm sẽ mặc định thực hiện việc khớp một phần.
matchFormulaText(matchFormulaText)TextFinderNếu là true, hãy định cấu hình lệnh tìm kiếm để trả về kết quả 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ị.
replaceAllWith(replaceText)IntegerThay thế tất cả các kết quả trùng khớp bằng văn bản được chỉ định.
replaceWith(replaceText)IntegerThay thế văn bản tìm kiếm trong ô hiện khớp bằng văn bản được 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 là true, hãy định cấu hình cụm từ tìm kiếm để diễn giải chuỗi tìm kiếm dưới dạng một biểu thức chính quy; nếu không, cụm từ tìm kiếm sẽ diễn giải chuỗi tìm kiếm là văn bản thông thường.

Tài liệu chi tiết

findAll()

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

Cầu thủ trả bóng

Range[] – Tất cả ô phù hợp.

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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ó kết quả trùng khớp nào trước đó.

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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ó kết quả trùng khớp nào trước đó.

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 – Ô khớp hiện tại hoặc null nếu không có thêm kết quả trùng khớp nào.

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 là true, hãy định cấu hình lượt tìm kiếm để bỏ qua các dấu phụ trong khi so khớp; nếu không, kết quả tìm kiếm sẽ khớp với các 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 móc dưới. Khi được viết ở trên hoặc dưới một chữ cái, dấu phụ sẽ cho biết sự khác biệt về cách phát âm so với cùng một chữ cái, khi được đánh dấu hoặc đánh dấu khác.

Các tham số

TênLoạiNội dung mô tả
ignoreDiacriticsBooleanLiệu tìm kiếm có cân nhắ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

Tập lệnh sử dụng phương thức này cần đượ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 là true, hãy định cấu hình cụm từ tìm kiếm cho khớp chính xác với trường hợp của văn bản tìm kiếm, nếu không, chế độ tìm kiếm sẽ mặc định chuyển thành kiểu khớp không phân biệt chữ hoa chữ thường.

Các tham số

TênLoạiNội dung mô tả
matchCaseBooleanKết quả 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

Tập lệnh sử dụng phương thức này cần đượ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 là true, hãy định cấu hình lệnh tìm kiếm để khớp với toàn bộ nội dung của một ô; nếu không, chế độ tìm kiếm sẽ mặc định thực hiện việc khớp một phần.

Các tham số

TênLoạiNội dung mô tả
matchEntireCellBooleanLiệu toàn bộ ô có 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

Tập lệnh sử dụng phương thức này cần đượ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 là true, hãy định cấu hình lệnh tìm kiếm để trả về kết quả 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ác tham số

TênLoạiNội dung mô tả
matchFormulaTextBooleanLiệu lượt 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

Tập lệnh sử dụng phương thức này cần đượ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ả các kết quả trùng khớp bằng văn bản được chỉ định. Trả về số lần xuất hiện được thay thế, có thể khác với số ô khớp.

Các tham số

TênLoạiNội dung mô tả
replaceTextStringVăn bản thay thế văn bản trong các ô phù hợp.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 khớp bằng văn bản được chỉ định và trả về số lần xuất hiện được thay thế.

Các tham số

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

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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.

Các tham số

TênLoạiNội dung mô tả
startRangeRangeDải ô 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

Tập lệnh sử dụng phương thức này cần đượ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 là true, hãy định cấu hình cụm từ tìm kiếm để diễn giải chuỗi tìm kiếm dưới dạng một biểu thức chính quy; nếu không, cụm từ tìm kiếm sẽ diễn giải chuỗi tìm kiếm là 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ợ Tìm và thay thế.

Các tham số

TênLoạiNội dung mô tả
useRegExBooleanLiệu có diễn giải chuỗi tìm kiếm dưới dạng một 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

Tập lệnh sử dụng phương thức này cần đượ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