Class TextFinder

MetinBul

Bir aralık, sayfa veya e-tablodaki metni bulun ya da değiştirin. Arama seçeneklerini de belirtebilirsiniz.

Yöntemler

YöntemDönüş türüKısa açıklama
findAll()Range[]Arama ölçütleriyle eşleşen tüm hücreleri döndürür.
findNext()RangeArama ölçütleriyle eşleşen bir sonraki hücreyi döndürür.
findPrevious()RangeArama ölçütleriyle eşleşen önceki hücreyi döndürür.
getCurrentMatch()RangeArama ölçütleriyle eşleşen geçerli hücreyi döndürür.
ignoreDiacritics(ignoreDiacritics)TextFindertrue ise aramayı, eşleştirme sırasında aksan işaretlerini yoksayacak şekilde yapılandırır. Aksi takdirde arama, aksan işaretlerini eşleştirir.
matchCase(matchCase)TextFindertrue ise aramayı, arama metninin büyük/küçük harf kullanımını tam olarak eşleyecek şekilde yapılandırır. Aksi takdirde arama, büyük/küçük harfe duyarlı olmayan eşlemeye varsayılan olarak ayarlanır.
matchEntireCell(matchEntireCell)TextFindertrue ise aramayı bir hücrenin tüm içeriğiyle eşleşecek şekilde yapılandırır. Aksi takdirde arama varsayılan olarak kısmi eşleşmeye ayarlanır.
matchFormulaText(matchFormulaText)TextFindertrue ise aramayı, formül metninde görünen eşleşmeleri döndürecek şekilde yapılandırır. Aksi takdirde, formül içeren hücreler, gösterilen değerlerine göre değerlendirilir.
replaceAllWith(replaceText)IntegerTüm eşleşmeleri belirtilen metinle değiştirir.
replaceWith(replaceText)IntegerO anda eşleşen hücredeki arama metnini belirtilen metinle değiştirir ve değiştirilen metinlerin sayısını döndürür.
startFrom(startRange)TextFinderArama işlemini, belirtilen hücre aralığından hemen sonra aramaya başlayacak şekilde yapılandırır.
useRegularExpression(useRegEx)TextFindertrue ise aramayı, arama dizesini normal ifade olarak yorumlayacak şekilde yapılandırır. Aksi takdirde arama, arama dizesini normal metin olarak yorumlar.

Ayrıntılı dokümanlar

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

findNext()

Arama ölçütleriyle eşleşen bir sonraki hücreyi döndürür.

Return

Range: Eşleşen bir sonraki hücre veya önceki eşleme yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Mevcut eşleşen hücre veya başka eşleşme yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

ignoreDiacritics(ignoreDiacritics)

true ise aramayı, eşleştirme sırasında aksan işaretlerini yoksayacak şekilde yapılandırır. Aksi takdirde arama, aksan işaretlerini eşleştirir. Aksan işareti veya cedilla gibi işaretler, bir harfin üzerine veya altına yazılarak işaretsiz veya farklı işaretli aynı harfin telaffuzunda bir fark olduğunu gösterir.

Parametreler

AdTürAçıklama
ignoreDiacriticsBooleanAramada aksan işaretlerinin dikkate alınıp alınmadığı.

Return

TextFinder: Zincirleme için bu metin bulucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

matchCase(matchCase)

true ise aramayı, arama metninin büyük/küçük harf kullanımını tam olarak eşleyecek şekilde yapılandırır. Aksi takdirde arama, büyük/küçük harfe duyarlı olmayan eşlemeye varsayılan olarak ayarlanır.

Parametreler

AdTürAçıklama
matchCaseBooleanEşleşmenin büyük/küçük harfe duyarlı olup olmadığı.

Return

TextFinder: Zincirleme için bu metin bulucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

matchEntireCell(matchEntireCell)

true ise aramayı bir hücrenin tüm içeriğiyle eşleşecek şekilde yapılandırır. Aksi takdirde arama varsayılan olarak kısmi eşleşmeye ayarlanır.

Parametreler

AdTürAçıklama
matchEntireCellBooleanHücrenin tamamının eşlenip eşlenmediği.

Return

TextFinder: Zincirleme için bu metin bulucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

matchFormulaText(matchFormulaText)

true ise aramayı, formül metninde görünen eşleşmeleri döndürecek şekilde yapılandırır. Aksi takdirde, formül içeren hücreler, gösterilen değerlerine göre değerlendirilir.

Parametreler

AdTürAçıklama
matchFormulaTextBooleanAramanın formül metnini inceleyip incelemediği.

Return

TextFinder: Zincirleme için bu metin bulucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 tekrar sayısını döndürür. Bu sayı, eşleşen hücrelerin sayısından farklı olabilir.

Parametreler

AdTürAçıklama
replaceTextStringEşleşen hücrelerdeki metni değiştiren metin.

Return

Integer: Değiştirilen tekrar sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

replaceWith(replaceText)

O anda eşleşen hücredeki arama metnini belirtilen metinle değiştirir ve değiştirilen metinlerin sayısını döndürür.

Parametreler

AdTürAçıklama
replaceTextStringŞu anda eşleşen hücredeki içeriği değiştiren metin.

Return

Integer: Değiştirilen tekrar sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

startFrom(startRange)

Arama işlemini, belirtilen hücre aralığından hemen sonra aramaya başlayacak şekilde yapılandırır.

Parametreler

AdTürAçıklama
startRangeRangeAramanın başlaması gereken hücre aralığı.

Return

TextFinder: Zincirleme için bu metin bulucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

useRegularExpression(useRegEx)

true ise aramayı, arama dizesini normal ifade olarak yorumlayacak şekilde yapılandırır. Aksi takdirde arama, arama dizesini normal metin olarak yorumlar. Normal ifadelerin nasıl kullanılacağı hakkında daha fazla bilgi için Bul ve değiştir destek sayfasına bakın.

Parametreler

AdTürAçıklama
useRegExBooleanArama dizesinin normal ifade olarak yorumlanıp yorumlanmayacağını belirtir.

Return

TextFinder: Zincirleme için bu metin bulucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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