Tìm hoặc thay thế văn bản trong một dải ô, trang tính hoặc bảng tính. Bạn cũng có thể chỉ định các lựa 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 |
|---|---|---|
find | Range[] | Trả về tất cả các ô khớp với tiêu chí tìm kiếm. |
find | Range | Trả về ô tiếp theo khớp với tiêu chí tìm kiếm. |
find | Range | Trả về ô trước đó khớp với tiêu chí tìm kiếm. |
get | Range | Trả về ô hiện tại khớp với tiêu chí tìm kiếm. |
ignore | Text | Nếu true, hãy định cấu hình chế độ tìm kiếm để bỏ qua dấu phụ trong khi so khớp; nếu không, chế độ tìm kiếm sẽ so khớp dấu phụ. |
match | Text | Nếu true, hãy định cấu hình tìm kiếm để khớp chính xác trường hợp của văn bản tìm kiếm, nếu không, tìm kiếm sẽ mặc định là so khớp không phân biệt chữ hoa chữ thường. |
match | Text | Nếu true, hãy định cấu hì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 mặc định sẽ là khớp một phần. |
match | Text | Nếu là true, hãy định cấu hình tìm kiếm để trả về các 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ủa chúng. |
replace | Integer | Thay thế tất cả các kết quả trùng khớp bằng văn bản đã chỉ định. |
replace | Integer | Thay thế văn bản tìm kiếm trong ô hiện khớp bằng văn bản đã chỉ định và trả về số lần thay thế. |
start | Text | Định cấu hình để bắt đầu tìm kiếm ngay sau dải ô được chỉ định. |
use | Text | Nếu true, hãy định cấu hình 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ì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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 – Ô trùng khớp tiếp theo hoặc null nếu không có ô trùng khớp trước đó.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ó ô trùng khớp nào khác.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 chế độ tìm kiếm để bỏ qua dấu phụ trong khi so khớp; nếu không, chế độ tìm kiếm sẽ so khớp dấu phụ. Dấu phụ là một ký hiệu, chẳng hạn như dấu trọng âm hoặc dấu móc dưới, khi được viết phía trên hoặc phía dưới một chữ cái 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 không có dấu hoặc có dấu khác.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
ignore | Boolean | Liệu cụm từ tìm kiếm có xem xét dấu phụ hay không. |
Cầu thủ trả bóng
TextFinder – Công cụ tìm văn bản này, để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ìm kiếm để khớp chính xác chữ hoa chữ thường của văn bản tìm kiếm, nếu không, chế độ tìm kiếm sẽ mặc định là so khớp không phân biệt chữ hoa chữ thường.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
match | Boolean | Liệ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 – Công cụ tìm văn bản này, để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 với toàn bộ nội dung của một ô; nếu không, chế độ tìm kiếm mặc định sẽ là khớp một phần.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
match | Boolean | Toàn bộ ô có khớp hay không. |
Cầu thủ trả bóng
TextFinder – Công cụ tìm văn bản này, để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 tìm kiếm để trả về các 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ủa chúng.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
match | Boolean | Liệu nội dung 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 – Công cụ tìm văn bản này, để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 đã chỉ định. Trả về số lần thay thế, có thể khác với số ô khớp.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
replace | String | Văn bản thay thế văn bản trong các ô trùng 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 đã chỉ định và trả về số lần thay thế.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
replace | String | Văn bản thay thế nội dung trong ô hiện đượ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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Định cấu hình để bắt đầu tìm kiếm ngay sau dải ô được chỉ định.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
start | Range | Dải ô mà sau đó quá trình tìm kiếm sẽ bắt đầu. |
Cầu thủ trả bóng
TextFinder – Công cụ tìm văn bản này, để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ì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ì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ợ Tìm và thay thế.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
use | Boolean | 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 – Công cụ tìm văn bản này, để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets