Class TextRange

RentangTeks

Segmen konten teks Shape atau TableCell.

Jika Anda menggunakan metode yang mengedit cara teks sesuai dengan bentuk, setelan penyesuaian otomatis apa pun yang diterapkan ke bentuk akan dinonaktifkan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
appendParagraph(text)ParagraphMenambahkan paragraf di akhir rentang teks.
appendRange(textRange)TextRangeMenambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.
appendRange(textRange, matchSourceFormatting)TextRangeMenambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.
appendText(text)TextRangeMenambahkan teks di akhir rentang teks.
asRenderedString()StringMenampilkan teks yang dirender yang dibatasi oleh rentang bentuk atau sel tabel terkait dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.
asString()StringMenampilkan teks mentah yang dibatasi oleh rentang sel tabel atau bentuk terkait ini.
clear()voidMenghapus teks yang dibatasi oleh rentang ini.
clear(startOffset, endOffset)voidMenghapus teks yang dibatasi oleh offset awal dan akhir dalam rentang.
find(pattern)TextRange[]Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini.
find(pattern, startOffset)TextRange[]Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini mulai dari offset awal.
getAutoTexts()AutoText[]Menampilkan teks otomatis dalam rentang teks saat ini.
getEndIndex()IntegerMenampilkan indeks eksklusif berbasis 0 untuk karakter terakhir dalam rentang ini.
getLength()IntegerMenampilkan jumlah karakter dalam rentang ini.
getLinks()TextRange[]Menampilkan kumpulan rentang teks yang sesuai dengan semua Link dalam rentang teks saat ini atau tumpang-tindih dengan rentang teks saat ini.
getListParagraphs()Paragraph[]Menampilkan paragraf dalam daftar yang tumpang-tindih dengan rentang teks saat ini.
getListStyle()ListStyleMenampilkan ListStyle dari rentang teks saat ini.
getParagraphStyle()ParagraphStyleMenampilkan ParagraphStyle dari rentang teks saat ini.
getParagraphs()Paragraph[]Menampilkan paragraf yang tumpang-tindih dengan rentang teks saat ini.
getRange(startOffset, endOffset)TextRangeMenampilkan TextRange baru yang mencakup bagian dari rentang tempat TextRange berasal.
getRuns()TextRange[]Menampilkan run teks yang tumpang-tindih dengan rentang teks saat ini.
getStartIndex()IntegerMenampilkan indeks berbasis 0 yang inklusif untuk karakter pertama dalam rentang ini.
getTextStyle()TextStyleMenampilkan gaya teks rentang, atau null jika rentang kosong.
insertParagraph(startOffset, text)ParagraphMenyisipkan paragraf pada offset awal.
insertRange(startOffset, textRange)TextRangeMenyisipkan salinan rentang teks yang disediakan pada offset awal.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeMenyisipkan salinan rentang teks yang disediakan pada offset awal.
insertText(startOffset, text)TextRangeMenyisipkan teks pada offset awal.
isEmpty()BooleanMenampilkan true jika tidak ada karakter dalam rentang ini, dan menampilkan false jika tidak.
replaceAllText(findText, replaceText)IntegerMengganti semua instance teks yang cocok dengan teks temukan dengan teks ganti.
replaceAllText(findText, replaceText, matchCase)IntegerMengganti semua instance teks yang cocok dengan teks temukan dengan teks ganti.
select()voidHanya memilih TextRange dalam presentasi aktif dan menghapus pemilihan sebelumnya.
setText(newText)TextRangeMenetapkan teks yang dibatasi oleh rentang bentuk atau sel tabel terkait ini.

Dokumentasi mendetail

appendParagraph(text)

Menambahkan paragraf di akhir rentang teks. Paragraf mempertahankan gaya akhir rentang teks saat ini.

String teks yang disediakan ditambahkan sebagai paragraf dengan menambahkan setidaknya satu karakter baris baru di sekitarnya ke string.

Jika string teks yang diberikan berisi karakter baris baru (sehingga terdiri dari beberapa paragraf), paragraf terakhir yang ditambahkan akan ditampilkan.

Parameter

NamaJenisDeskripsi
textStringString yang akan ditambahkan sebagai paragraf.

Pulang pergi

Paragraph — Paragraph yang ditambahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

appendRange(textRange)

Menambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.

Format teks yang disisipkan akan cocok dengan format teks sumber.

Parameter

NamaJenisDeskripsi
textRangeTextRangeRentang teks yang akan ditambahkan.

Pulang pergi

TextRange — rentang teks yang mewakili teks yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

appendRange(textRange, matchSourceFormatting)

Menambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.

Jika ditetapkan agar cocok dengan pemformatan teks tujuan, AutoText dalam rentang teks yang disediakan akan diganti dengan nilai yang dirender. Selain itu, elemen non-teks apa pun dalam rentang teks yang disediakan tidak ditambahkan.

Parameter

NamaJenisDeskripsi
textRangeTextRangeRentang teks yang akan ditambahkan.
matchSourceFormattingBooleanJika true, cocokkan pemformatan teks sumber; jika false, cocokkan pemformatan teks tujuan.

Pulang pergi

TextRange — rentang teks yang mewakili teks yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

appendText(text)

Menambahkan teks di akhir rentang teks. Teks mempertahankan gaya akhir teks yang ada.

Parameter

NamaJenisDeskripsi
textStringString yang akan ditambahkan.

Pulang pergi

TextRange — rentang teks yang mewakili teks yang ditambahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

asRenderedString()

Menampilkan teks yang dirender yang dibatasi oleh rentang bentuk atau sel tabel terkait dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.

Elemen Teks Otomatis, seperti nomor slide yang dibuat, akan diganti dengan nilai yang dirender. Semua elemen non-teks dalam rentang akan dihilangkan.

Pulang pergi

String

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

asString()

Menampilkan teks mentah yang dibatasi oleh rentang sel tabel atau bentuk terkait ini.

Elemen Teks Otomatis seperti nomor slide yang dibuat dan elemen non-teks apa pun dalam rentang akan diganti dengan karakter Unicode U+E907.

Pulang pergi

String

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

clear()

Menghapus teks yang dibatasi oleh rentang ini.

Karena seluruh teks dalam Shape atau TableCell harus diakhiri dengan baris baru, baris baru terakhir dalam teks tidak akan dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

clear(startOffset, endOffset)

Menghapus teks yang dibatasi oleh offset awal dan akhir dalam rentang.

Karena teks harus diakhiri dengan baris baru, baris baru terakhir dalam teks tidak dihapus meskipun tercakup dalam offset yang diberikan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif rentang yang akan dihapus. Offset awal harus sama dengan atau lebih besar dari 0 dan kurang dari atau sama dengan endOffset. startOffset juga harus kurang dari panjang rentang saat ini.
endOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks akhir eksklusif rentang yang akan dihapus. endOffset harus sama dengan atau lebih besar dari startOffset. endOffset juga harus kurang dari atau sama dengan panjang rentang saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

find(pattern)

Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini. Penelusuran peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
patternStringPola ekspresi reguler yang akan ditelusuri; garis miring terbalik dalam pola harus di-escape.

Pulang pergi

TextRange[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

find(pattern, startOffset)

Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini mulai dari offset awal. Penelusuran peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
patternStringPola ekspresi reguler yang akan ditelusuri; garis miring terbalik dalam pola harus di-escape.
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif rentang yang akan ditelusuri. startOffset juga harus kurang dari panjang rentang saat ini.

Pulang pergi

TextRange[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAutoTexts()

Menampilkan teks otomatis dalam rentang teks saat ini.

Pulang pergi

AutoText[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getEndIndex()

Menampilkan indeks eksklusif berbasis 0 untuk karakter terakhir dalam rentang ini. Jika indeks awal dan akhir sama, rentang dianggap kosong.

Pulang pergi

Integer

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getLength()

Menampilkan jumlah karakter dalam rentang ini.

Pulang pergi

Integer

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Menampilkan kumpulan rentang teks yang sesuai dengan semua Link dalam rentang teks saat ini atau tumpang-tindih dengan rentang teks saat ini.

Setiap rentang yang ditampilkan dijamin mencakup satu link saat dibuat. Modifikasi teks dapat menyebabkannya tidak lagi merepresentasikan satu link saja.

Setiap Link pada rentang yang ditampilkan dapat diakses melalui TextStyle.getLink(). 

// 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

Pulang pergi

TextRange[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getListParagraphs()

Menampilkan paragraf dalam daftar yang tumpang-tindih dengan rentang teks saat ini.

Pulang pergi

Paragraph[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getListStyle()

Menampilkan ListStyle dari rentang teks saat ini.

Pulang pergi

ListStyle

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getParagraphStyle()

Menampilkan ParagraphStyle dari rentang teks saat ini.

Pulang pergi

ParagraphStyle

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getParagraphs()

Menampilkan paragraf yang tumpang-tindih dengan rentang teks saat ini.

Pulang pergi

Paragraph[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getRange(startOffset, endOffset)

Menampilkan TextRange baru yang mencakup bagian dari rentang tempat TextRange berasal.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif dari rentang yang ditampilkan. Offset awal harus sama dengan atau lebih besar dari 0 dan kurang dari atau sama dengan endOffset. startOffset juga harus kurang dari panjang rentang saat ini.
endOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks akhir eksklusif rentang yang ditampilkan. endOffset harus sama dengan atau lebih besar dari startOffset. endOffset juga harus kurang dari atau sama dengan panjang rentang saat ini.

Pulang pergi

TextRange

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getRuns()

Menampilkan run teks yang tumpang-tindih dengan rentang teks saat ini. Run teks adalah segmen teks dengan semua karakter memiliki gaya teks yang sama.

Setiap rentang yang ditampilkan hanya dijamin untuk mencakup satu operasi saat dibuat. Perubahan teks atau gaya dapat menyebabkannya tidak lagi mewakili persis satu run.

Pulang pergi

TextRange[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getStartIndex()

Menampilkan indeks berbasis 0 yang inklusif untuk karakter pertama dalam rentang ini. Jika indeks awal dan akhir sama, rentang dianggap kosong.

Pulang pergi

Integer

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getTextStyle()

Menampilkan gaya teks rentang, atau null jika rentang kosong.

Pulang pergi

TextStyle

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertParagraph(startOffset, text)

Menyisipkan paragraf pada offset awal. Paragraf mempertahankan gaya visual rentang teks saat ini pada offset awal.

String teks yang disediakan disisipkan sebagai paragraf dengan menambahkan setidaknya satu karakter awal baris baru di sekeliling string.

Jika string teks yang diberikan berisi karakter baris baru (sehingga terdiri dari beberapa paragraf), paragraf terakhir yang ditambahkan akan ditampilkan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textStringString yang akan disisipkan.

Pulang pergi

Paragraph — Paragraph yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertRange(startOffset, textRange)

Menyisipkan salinan rentang teks yang disediakan pada offset awal.

Format teks yang disisipkan akan cocok dengan format teks sumber.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textRangeTextRangeRentang teks yang akan disisipkan.

Pulang pergi

TextRange — rentang teks yang mewakili teks yang disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertRange(startOffset, textRange, matchSourceFormatting)

Menyisipkan salinan rentang teks yang disediakan pada offset awal.

Jika ditetapkan agar cocok dengan pemformatan teks tujuan, AutoText dalam rentang teks yang disediakan akan diganti dengan nilai yang dirender. Selain itu, elemen non-teks apa pun dalam rentang teks yang disediakan tidak akan disisipkan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textRangeTextRangeRentang teks yang akan disisipkan.
matchSourceFormattingBooleanJika true, cocokkan pemformatan teks sumber; jika false, cocokkan pemformatan teks tujuan.

Pulang pergi

TextRange — rentang teks yang mewakili teks yang disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertText(startOffset, text)

Menyisipkan teks pada offset awal. Teks mempertahankan gaya teks yang ada pada offset awal.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textStringString yang akan disisipkan.

Pulang pergi

TextRange — rentang teks yang mewakili teks yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

isEmpty()

Menampilkan true jika tidak ada karakter dalam rentang ini, dan menampilkan false jika tidak.

Pulang pergi

Boolean

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

replaceAllText(findText, replaceText)

Mengganti semua instance teks yang cocok dengan teks temukan dengan teks ganti. Penelusuran tidak peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks yang akan menggantikan teks yang cocok.

Pulang pergi

Integer — jumlah kemunculan yang diubah

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

replaceAllText(findText, replaceText, matchCase)

Mengganti semua instance teks yang cocok dengan teks temukan dengan teks ganti.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks yang akan menggantikan teks yang cocok.
matchCaseBooleanJika true, penelusuran peka huruf besar/kecil; jika false, penelusuran tidak peka huruf besar/kecil.

Pulang pergi

Integer — jumlah kemunculan yang diubah

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

select()

Hanya memilih TextRange dalam presentasi aktif dan menghapus pemilihan sebelumnya.

Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat dengan presentasi.

Page induk dari Shape atau TableCell yang sesuai ditetapkan sebagai current page selection. Shape atau TableCell ditetapkan sebagai selected page element.

    Selection dapat berupa dua jenis:
    • 1. Rentang teks, gunakan pilih pada TextRange yang tidak kosong untuk memilih rentang karakter.
    • 2. Posisi kursor, gunakan TextRange kosong untuk menempatkan kursor di indeks yang diinginkan. 
      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();

      Otorisasi

      Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

    setText(newText)

    Menetapkan teks yang dibatasi oleh rentang bentuk atau sel tabel terkait ini. Teks mempertahankan gaya awal teks yang ada.

    Parameter

    NamaJenisDeskripsi
    newTextStringString yang akan ditetapkan sebagai teks baru.

    Pulang pergi

    TextRange — rentang teks yang mewakili teks yang ditetapkan

    Otorisasi

    Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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