Class TextRange

MetinAralığı

Bir Shape veya TableCell'nin metin içeriklerinin bir bölümü.

Metnin bir şekle sığma biçimini düzenleyen yöntemler kullanırsanız şekle uygulanan tüm otomatik sığdırma ayarları devre dışı bırakılır.

Yöntemler

YöntemDönüş türüKısa açıklama
appendParagraph(text)ParagraphMetin aralığının sonuna bir paragraf ekler.
appendRange(textRange)TextRangeSağlanan metin aralığının bir kopyasını mevcut metin aralığının sonuna ekler.
appendRange(textRange, matchSourceFormatting)TextRangeSağlanan metin aralığının bir kopyasını mevcut metin aralığının sonuna ekler.
appendText(text)TextRangeMetin aralığının sonuna metin ekler.
asRenderedString()Stringİlişkili şeklin veya tablo hücresinin bu aralığıyla sınırlanmış oluşturulmuş metni, son kullanıcılara gösterilmeye uygun bir biçimde döndürür.
asString()Stringİlişkili şeklin veya tablo hücresinin bu aralığıyla sınırlanmış ham metni döndürür.
clear()voidBu aralıkla sınırlanan metni temizler.
clear(startOffset, endOffset)voidAralıktaki başlangıç ve bitiş ofsetleriyle sınırlanan metni temizler.
find(pattern)TextRange[]Geçerli metin aralığındaki arama modeliyle eşleşen tüm aralıkları döndürür.
find(pattern, startOffset)TextRange[]Başlangıç uzaklığından başlayarak geçerli metin aralığındaki arama kalıbıyla eşleşen tüm aralıkları döndürür.
getAutoTexts()AutoText[]Geçerli metin aralığındaki otomatik metinleri döndürür.
getEndIndex()IntegerBu aralıktaki son karakterin 0 tabanlı dizinini (hariç) döndürür.
getLength()IntegerBu aralıktaki karakter sayısını döndürür.
getLinks()TextRange[]Geçerli metin aralığındaki veya geçerli metin aralığıyla çakışan tüm Link'lere karşılık gelen bir metin aralıkları koleksiyonunu döndürür.
getListParagraphs()Paragraph[]Listelerde, geçerli metin aralığıyla çakışan paragrafları döndürür.
getListStyle()ListStyleGeçerli metin aralığının ListStyle değerini döndürür.
getParagraphStyle()ParagraphStyleGeçerli metin aralığının ParagraphStyle değerini döndürür.
getParagraphs()Paragraph[]Geçerli metin aralığıyla çakışan paragrafları döndürür.
getRange(startOffset, endOffset)TextRangeTüretildiği aralığın bir kısmını kapsayan yeni bir TextRange döndürür.
getRuns()TextRange[]Geçerli metin aralığıyla çakışan metin çalıştırmalarını döndürür.
getStartIndex()IntegerBu aralıktaki ilk karakterin 0 tabanlı dizinini (dahil) döndürür.
getTextStyle()TextStyleAralığın metin stilini veya aralık boşsa null değerini döndürür.
insertParagraph(startOffset, text)ParagraphBaşlangıç uzaklığında bir paragraf ekler.
insertRange(startOffset, textRange)TextRangeBelirtilen metin aralığının bir kopyasını başlangıç ofsetine ekler.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeBelirtilen metin aralığının bir kopyasını başlangıç ofsetine ekler.
insertText(startOffset, text)TextRangeMetni başlangıç uzaklığına ekler.
isEmpty()BooleanBu aralıkta karakter yoksa true, aksi takdirde false değerini döndürür.
replaceAllText(findText, replaceText)IntegerBulunan metne uyan tüm metin örneklerini yeni metinle değiştirir.
replaceAllText(findText, replaceText, matchCase)IntegerBulunan metne uyan tüm metin örneklerini yeni metinle değiştirir.
select()voidYalnızca etkin sunudaki TextRange öğesini seçer ve önceki seçimleri kaldırır.
setText(newText)TextRangeİlişkili şeklin veya tablo hücresinin bu aralıkla sınırlanan metnini ayarlar.

Ayrıntılı belgeler

appendParagraph(text)

Metin aralığının sonuna bir paragraf ekler. Paragraf, geçerli metin aralığının sonundaki stili korur.

Sağlanan metin dizesi, dizeye en az bir çevreleyen yeni satır karakteri eklenerek paragraf olarak eklenir.

Sağlanan metin dizesi yeni satır karakterleri içerdiğinde (dolayısıyla birden fazla paragraftan oluştuğunda) eklenen son paragraf döndürülür.

Parametreler

AdTürAçıklama
textStringParagraf olarak eklenecek dize.

Return

Paragraph — Eklenen Paragraph.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

appendRange(textRange)

Sağlanan metin aralığının bir kopyasını mevcut metin aralığının sonuna ekler.

Eklenen metnin biçimlendirmesi, kaynak metnin biçimlendirmesiyle eşleşir.

Parametreler

AdTürAçıklama
textRangeTextRangeEklenecek metin aralığı.

Return

TextRange — Eklenen metni temsil eden metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

appendRange(textRange, matchSourceFormatting)

Sağlanan metin aralığının bir kopyasını mevcut metin aralığının sonuna ekler.

Hedef metnin biçimlendirmesiyle eşleşecek şekilde ayarlanırsa sağlanan metin aralığındaki AutoText, oluşturulan değerleriyle değiştirilir. Ayrıca, sağlanan metin aralığındaki metin dışı öğeler eklenmez.

Parametreler

AdTürAçıklama
textRangeTextRangeEklenecek metin aralığı.
matchSourceFormattingBooleantrue ise kaynak metnin biçimlendirmesini eşleştirin; false ise hedef metnin biçimlendirmesini eşleştirin.

Return

TextRange — Eklenen metni temsil eden metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

appendText(text)

Metin aralığının sonuna metin ekler. Metin, mevcut metnin sonundaki stili korur.

Parametreler

AdTürAçıklama
textStringEklenecek dize.

Return

TextRange — Eklenen metni temsil eden metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

asRenderedString()

İlişkili şeklin veya tablo hücresinin bu aralığıyla sınırlanmış oluşturulmuş metni, son kullanıcılara gösterilmeye uygun bir biçimde döndürür.

OtomatikOluşturulan slayt numaraları gibi metin öğeleri, oluşturulan değerleriyle değiştirilir. Aralıktaki metin olmayan öğeler atlanır.

Return

String: Aralıktaki oluşturulan metin.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

asString()

İlişkili şeklin veya tablo hücresinin bu aralığıyla sınırlanmış ham metni döndürür.

OtomatikOluşturulan slayt numaraları gibi metin öğeleri ve aralıktaki metin olmayan öğeler, Unicode karakteri U+E907 ile değiştirilir.

Return

String: Aralıktaki ham metin.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

clear()

Bu aralıkla sınırlanan metni temizler.

Bir Şekil veya TableCell'deki metnin tamamı yeni satırla bitmek zorunda olduğundan, metindeki son yeni satır kaldırılmaz.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

clear(startOffset, endOffset)

Aralıktaki başlangıç ve bitiş ofsetleriyle sınırlanan metni temizler.

Metin yeni bir satırla sona ermesi gerektiğinden, verilen ofsetlerle kapsansa bile metindeki son yeni satır kaldırılmaz.

Parametreler

AdTürAçıklama
startOffsetIntegerTemizlenecek aralığın kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı. Başlangıç ofseti 0'a eşit veya 0'dan büyük ve endOffset değerinden küçük ya da bu değere eşit olmalıdır. startOffset de geçerli aralığın uzunluğundan kısa olmalıdır.
endOffsetIntegerTemizlenecek aralığın hariç tutulan bitiş dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı. endOffset, startOffset değerine eşit veya bu değerden büyük olmalıdır. endOffset, mevcut aralığın uzunluğundan küçük veya ona eşit olmalıdır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

find(pattern)

Geçerli metin aralığındaki arama modeliyle eşleşen tüm aralıkları döndürür. Arama büyük/küçük harfe duyarlıdır.

Parametreler

AdTürAçıklama
patternStringAranacak normal ifade deseni. Desendeki tüm ters eğik çizgiler kaçırılmalıdır.

Return

TextRange[]: Metin aralıklarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

find(pattern, startOffset)

Başlangıç uzaklığından başlayarak geçerli metin aralığındaki arama kalıbıyla eşleşen tüm aralıkları döndürür. Arama büyük/küçük harfe duyarlıdır.

Parametreler

AdTürAçıklama
patternStringAranacak normal ifade deseni. Desendeki tüm ters eğik çizgiler kaçırılmalıdır.
startOffsetIntegerArama yapılacak aralığın kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı. startOffset, mevcut aralığın uzunluğundan da kısa olmalıdır.

Return

TextRange[]: Metin aralıklarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getAutoTexts()

Geçerli metin aralığındaki otomatik metinleri döndürür.

Return

AutoText[]: Otomatik metinlerin listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getEndIndex()

Bu aralıktaki son karakterin 0 tabanlı dizinini (hariç) döndürür. Başlangıç ve bitiş dizinleri eşitse aralığın boş olduğu kabul edilir.

Return

Integer: Aralığın bitiş dizini.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getLength()

Bu aralıktaki karakter sayısını döndürür.

Return

Integer: Bu aralıktaki karakter 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Geçerli metin aralığındaki veya geçerli metin aralığıyla çakışan tüm Link'lere karşılık gelen bir metin aralıkları koleksiyonunu döndürür.

Döndürülen her aralığın, oluşturulduğunda tek bir bağlantıyı kapsayacağı garanti edilir. Metin değişiklikleri, bağlantının artık tam olarak tek bir bağlantıyı temsil etmemesine neden olabilir.

Döndürülen aralıklardaki her Link öğesine TextStyle.getLink() üzerinden erişilebilir. 

// Accesses the first link on a TextRange object. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); const linkTextRange = textRange.getLinks()[0]; const textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink());   // logs 'true' const link = textStyle.getLink();  // Link object

Return

TextRange[]: Metin aralıklarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getListParagraphs()

Listelerde, geçerli metin aralığıyla çakışan paragrafları döndürür.

Return

Paragraph[]: Listelerdeki paragrafların listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getListStyle()

Geçerli metin aralığının ListStyle değerini döndürür.

Return

ListStyle: Geçerli metin aralığının liste stili.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getParagraphStyle()

Geçerli metin aralığının ParagraphStyle değerini döndürür.

Return

ParagraphStyle: Geçerli metin aralığının paragraf stili.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getParagraphs()

Geçerli metin aralığıyla çakışan paragrafları döndürür.

Return

Paragraph[]: Paragrafların listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRange(startOffset, endOffset)

Türetildiği aralığın bir kısmını kapsayan yeni bir TextRange döndürür.

Parametreler

AdTürAçıklama
startOffsetIntegerDöndürülen aralığın kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı. Başlangıç ofseti 0'a eşit veya 0'dan büyük ve endOffset değerinden küçük ya da bu değere eşit olmalıdır. startOffset de geçerli aralığın uzunluğundan kısa olmalıdır.
endOffsetIntegerDöndürülen aralığın hariç tutulan bitiş dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı. endOffset, startOffset değerine eşit veya bu değerden büyük olmalıdır. endOffset, mevcut aralığın uzunluğundan küçük veya ona eşit olmalıdır.

Return

TextRange: Yeni bir metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRuns()

Geçerli metin aralığıyla çakışan metin çalıştırmalarını döndürür. Metin çalıştırması, tüm karakterlerin aynı metin stiline sahip olduğu bir metin segmentidir.

Döndürülen her aralığın, oluşturulduğu sırada yalnızca bir çalıştırma kapsamını kapsayacağı garanti edilir. Metin veya stil değişiklikleri, bu öğenin artık tam olarak bir çalıştırmayı temsil etmemesine neden olabilir.

Return

TextRange[]: Metin aralıklarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getStartIndex()

Bu aralıktaki ilk karakterin 0 tabanlı dizinini (dahil) döndürür. Başlangıç ve bitiş dizinleri eşitse aralığın boş olduğu kabul edilir.

Return

Integer: Aralığın başlangıç dizini.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTextStyle()

Aralığın metin stilini veya aralık boşsa null değerini döndürür.

Return

TextStyle: Aralığın metin stili.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertParagraph(startOffset, text)

Başlangıç uzaklığında bir paragraf ekler. Paragraf, başlangıç uzaklığında geçerli metin aralığının stilini korur.

Sağlanan metin dizesi, dizeye en az bir çevreleyen yeni satır karakteri eklenerek paragraf olarak eklenir.

Sağlanan metin dizesi yeni satır karakterleri içerdiğinde (dolayısıyla birden fazla paragraftan oluştuğunda) eklenen son paragraf döndürülür.

Parametreler

AdTürAçıklama
startOffsetIntegerEklenecek metnin kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı.
textStringEklenecek dize.

Return

Paragraph — Eklenen Paragraph.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertRange(startOffset, textRange)

Belirtilen metin aralığının bir kopyasını başlangıç ofsetine ekler.

Eklenen metnin biçimlendirmesi, kaynak metnin biçimlendirmesiyle eşleşir.

Parametreler

AdTürAçıklama
startOffsetIntegerEklenecek metnin kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı.
textRangeTextRangeEklenecek metin aralığı.

Return

TextRange: Eklenen metni temsil eden metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertRange(startOffset, textRange, matchSourceFormatting)

Belirtilen metin aralığının bir kopyasını başlangıç ofsetine ekler.

Hedef metnin biçimlendirmesiyle eşleşecek şekilde ayarlanırsa sağlanan metin aralığındaki AutoText, oluşturulan değerleriyle değiştirilir. Ayrıca, sağlanan metin aralığındaki metin olmayan öğeler de eklenmez.

Parametreler

AdTürAçıklama
startOffsetIntegerEklenecek metnin kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı.
textRangeTextRangeEklenecek metin aralığı.
matchSourceFormattingBooleantrue ise kaynak metnin biçimlendirmesini eşleştirin; false ise hedef metnin biçimlendirmesini eşleştirin.

Return

TextRange: Eklenen metni temsil eden metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertText(startOffset, text)

Metni başlangıç uzaklığına ekler. Metin, başlangıç uzaklığındaki mevcut metnin stilini korur.

Parametreler

AdTürAçıklama
startOffsetIntegerEklenecek metnin kapsayıcı başlangıç dizinini belirlemek için kullanılan, geçerli metin aralığının başlangıç dizininden sonraki karakter sayısı.
textStringEklenecek dize.

Return

TextRange: Eklenen metni temsil eden metin aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

isEmpty()

Bu aralıkta karakter yoksa true, aksi takdirde false değerini döndürür.

Return

Bu aralıkta karakter yoksa Boolean — true, aksi takdirde false değerini döndürür.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

replaceAllText(findText, replaceText)

Bulunan metne uyan tüm metin örneklerini yeni metinle değiştirir. Arama büyük/küçük harfe duyarlı değildir.

Parametreler

AdTürAçıklama
findTextStringBulunacak metin.
replaceTextStringEşleşen metnin yerine kullanılacak metin.

Return

Integer: Değişen 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

Bulunan metne uyan tüm metin örneklerini yeni metinle değiştirir.

Parametreler

AdTürAçıklama
findTextStringBulunacak metin.
replaceTextStringEşleşen metnin yerine kullanılacak metin.
matchCaseBooleantrue ise arama büyük/küçük harfe duyarlıdır. false ise arama büyük/küçük harfe duyarlı değildir.

Return

Integer: Değişen 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

Yalnızca etkin sunudaki TextRange öğesini seçer ve önceki seçimleri kaldırır.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve yalnızca komut dosyası sunuya bağlıysa bu işlemi yapabilir.

İlgili Shape veya TableCell öğesinin üst Page, current page selection olarak ayarlanır. Shape veya TableCell, selected page element olarak ayarlanır.

    Selection iki türde olabilir:
    • 1. Metin aralığı: Karakter aralığını seçmek için boş olmayan bir TextRange üzerinde seçim işlemini kullanın.
    • 2. İmleç konumu: İmleci istediğiniz dizine yerleştirmek için boş bir TextRange kullanın. 
      const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText('Hello'); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();

      Yetkilendirme

      Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

    setText(newText)

    İlişkili şeklin veya tablo hücresinin bu aralıkla sınırlanan metnini ayarlar. Metin, mevcut metnin başlangıcındaki stili korur.

    Parametreler

    AdTürAçıklama
    newTextStringYeni metin olarak ayarlanacak dize.

    Return

    TextRange: Ayarlanan metni temsil eden metin aralığı.

    Yetkilendirme

    Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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