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ức | Kiể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() | Range | Trả về ô tiếp theo khớp với tiêu chí tìm kiếm. |
findPrevious() | Range | Trả về ô trước đó khớp với tiêu chí tìm kiếm. |
getCurrentMatch() | Range | Trả về ô hiện tại khớp với tiêu chí tìm kiếm. |
ignoreDiacritics(ignoreDiacritics) | TextFinder | 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ụ. |
matchCase(matchCase) | TextFinder | 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. |
matchEntireCell(matchEntireCell) | TextFinder | 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. |
matchFormulaText(matchFormulaText) | TextFinder | 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ị. |
replaceAllWith(replaceText) | Integer | Thay thế tất cả các kết quả trùng khớp bằng văn bản được chỉ định. |
replaceWith(replaceText) | Integer | 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ế. |
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) | TextFinder | 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. |
Tài liệu chi tiết
findAll()
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ên | Loại | Nội dung mô tả |
|---|---|---|
ignoreDiacritics | Boolean | Liệ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ên | Loại | Nội dung mô tả |
|---|---|---|
matchCase | Boolean | Kế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ên | Loại | Nội dung mô tả |
|---|---|---|
matchEntireCell | Boolean | Liệ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ên | Loại | Nội dung mô tả |
|---|---|---|
matchFormulaText | Boolean | Liệ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ên | Loại | Nội dung mô tả |
|---|---|---|
replaceText | String | Vă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ên | Loại | Nội dung mô tả |
|---|---|---|
replaceText | String | Vă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ên | Loại | Nội dung mô tả |
|---|---|---|
startRange | Range | Dả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ên | Loại | Nội dung mô tả |
|---|---|---|
useRegEx | Boolean | Liệ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