Bir aralık, sayfa veya e-tablodaki metni bulma ya da değiştirme Arama seçeneklerini de belirtebilirsiniz.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
find | Range[] | Arama ölçütleriyle eşleşen tüm hücreleri döndürür. |
find | Range | Arama ölçütleriyle eşleşen sonraki hücreyi döndürür. |
find | Range | Arama ölçütleriyle eşleşen önceki hücreyi döndürür. |
get | Range | Arama ölçütleriyle eşleşen geçerli hücreyi döndürür. |
ignore | Text | true ise arama, eşleştirme sırasında aksan işaretlerini yoksayacak şekilde yapılandırılır. Aksi takdirde arama, aksan işaretleriyle eşleşir. |
match | Text | true ise aramanın, arama metninin büyük/küçük harf durumunu tam olarak eşleştirecek şekilde yapılandırılmasını sağlar. Aksi takdirde, arama varsayılan olarak büyük/küçük harfe duyarsız eşleşme kullanır. |
match | Text | true ise arama, bir hücrenin tüm içeriğiyle eşleşecek şekilde yapılandırılır. Aksi takdirde, arama varsayılan olarak kısmi eşleşme yapar. |
match | Text | true ise arama, formül metninde görünen eşleşmeleri döndürecek şekilde yapılandırılır;
aksi takdirde formül içeren hücreler, gösterilen değerlerine göre değerlendirilir. |
replace | Integer | Tüm eşleşmeleri belirtilen metinle değiştirir. |
replace | Integer | Şu anda eşleşen hücredeki arama metnini belirtilen metinle değiştirir ve değiştirilen oluşum sayısını döndürür. |
start | Text | Aramanın, belirtilen hücre aralığından hemen sonra başlamasını sağlar. |
use | Text | true ise aramanın, arama dizesini normal ifade olarak yorumlamasını sağlar;
aksi takdirde arama, arama dizesini normal metin olarak yorumlar. |
Ayrıntılı belgeler
findAll()
Arama ölçütleriyle eşleşen tüm hücreleri döndürür.
Return
Range[]: Eşleşen tüm hücreler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Arama ölçütleriyle eşleşen sonraki hücreyi döndürür.
Return
Range: Eşleşen bir sonraki hücre veya önceki eşleşme yoksa null.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Arama ölçütleriyle eşleşen önceki hücreyi döndürür.
Return
Range: Önceki eşleşen hücre veya önceki eşleşme yoksa null.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Arama ölçütleriyle eşleşen geçerli hücreyi döndürür.
Return
Range: Geçerli eşleşen hücre veya başka eşleşme yoksa null.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
true ise arama, eşleştirme sırasında aksan işaretlerini yoksayacak şekilde yapılandırılır. Aksi takdirde arama, aksan işaretleriyle eşleşir. Aksan veya alt nokta gibi bir işaret olan diyakritik, bir harfin üzerine veya altına yazıldığında, işaretsiz veya farklı şekilde işaretlenmiş aynı harfin telaffuzunda bir farklılık olduğunu gösterir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
ignore | Boolean | Aramada aksan işaretlerinin dikkate alınıp alınmadığı. |
Return
TextFinder: Zincirleme için kullanılan bu metin bulucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
true ise aramanın, arama metninin büyük/küçük harf durumunu tam olarak eşleştirecek şekilde yapılandırılmasını sağlar. Aksi takdirde, arama varsayılan olarak büyük/küçük harfe duyarsız eşleşme kullanır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
match | Boolean | Eşleşmenin büyük/küçük harfe duyarlı olup olmadığı. |
Return
TextFinder: Zincirleme için kullanılan bu metin bulucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
true ise arama, bir hücrenin tüm içeriğiyle eşleşecek şekilde yapılandırılır. Aksi takdirde, arama varsayılan olarak kısmi eşleşme yapar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
match | Boolean | Hücrenin tamamının eşleştirilip eşleştirilmediği |
Return
TextFinder: Zincirleme için kullanılan bu metin bulucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
true ise arama, formül metninde görünen eşleşmeleri döndürecek şekilde yapılandırılır;
aksi takdirde formül içeren hücreler, gösterilen değerlerine göre değerlendirilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
match | Boolean | Aramanın formül metnini inceleyip incelemediği. |
Return
TextFinder: Zincirleme için kullanılan bu metin bulucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Tüm eşleşmeleri belirtilen metinle değiştirir. Değiştirilen oluşum sayısını döndürür. Bu sayı, eşleşen hücre sayısından farklı olabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
replace | String | Eşleşen hücrelerdeki metnin yerine geçecek metin. |
Return
Integer: Değiştirilen tekrar sayısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Şu anda eşleşen hücredeki arama metnini belirtilen metinle değiştirir ve değiştirilen oluşum sayısını döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
replace | String | Şu anda eşleşen hücredeki içeriğin yerine geçen metin. |
Return
Integer: Değiştirilen tekrar sayısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Aramanın, belirtilen hücre aralığından hemen sonra başlamasını sağlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
start | Range | Aramanın başlatılacağı hücre aralığı. |
Return
TextFinder: Zincirleme için kullanılan bu metin bulucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
true ise aramanın, arama dizesini normal ifade olarak yorumlamasını sağlar;
aksi takdirde arama, arama dizesini normal metin olarak yorumlar. Normal ifadeleri kullanma hakkında daha fazla bilgi için
Bul ve değiştir destek sayfasına bakın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
use | Boolean | Arama dizesinin normal ifade olarak yorumlanıp yorumlanmayacağı. |
Return
TextFinder: Zincirleme için kullanılan bu metin bulucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets