Class TextRange

TextRange

Segmen konten teks dari Shape atau TableCell.

Jika Anda menggunakan metode yang mengedit cara teks dipaskan dalam bentuk, setiap setelan paskan otomatis yang diterapkan bentuknya 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 hasil render 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 dari bentuk atau sel tabel 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[]Mengembalikan 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 rentang tempatnya berasal.
getRuns()TextRange[]Menampilkan aliran teks yang tumpang-tindih dengan rentang teks saat ini.
getStartIndex()IntegerMenampilkan indeks inklusif berbasis 0 untuk karakter pertama dalam rentang ini.
getTextStyle()TextStyleMenampilkan gaya teks rentang, atau null jika rentang kosong.
insertParagraph(startOffset, text)ParagraphMenyisipkan paragraf di offset awal.
insertRange(startOffset, textRange)TextRangeMenyisipkan salinan rentang teks yang disediakan di offset awal.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeMenyisipkan salinan rentang teks yang disediakan di offset awal.
insertText(startOffset, text)TextRangeMenyisipkan teks di offset awal.
isEmpty()BooleanMenampilkan true jika tidak ada karakter dalam rentang ini, dan menampilkan false sebaliknya.
replaceAllText(findText, replaceText)IntegerMengganti semua contoh pencocokan teks temukan teks dengan teks pengganti.
replaceAllText(findText, replaceText, matchCase)IntegerMengganti semua contoh pencocokan teks temukan teks dengan teks pengganti.
select()voidHanya memilih TextRange di presentasi aktif dan menghapus yang sebelumnya pilihan.
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 tersebut mempertahankan gaya akhir rentang teks saat ini.

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

Saat {i>string<i} teks yang disediakan 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

ParagraphParagraph 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 sesuai 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 disetel agar sesuai dengan format teks tujuan, AutoText dalam kolom rentang teks diganti dengan nilai yang dirender. Selanjutnya, setiap elemen non-teks di dalam rentang teks yang disediakan tidak ditambahkan.

Parameter

NamaJenisDeskripsi
textRangeTextRangeRentang teks yang akan ditambahkan.
matchSourceFormattingBooleanJika true, cocokkan dengan format teks sumber; jika false, cocok dengan format 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 sudah 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 hasil render yang dibatasi oleh rentang bentuk atau sel tabel terkait dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.

Elemen AutoText, seperti nomor slide yang dihasilkan, diganti dengan nilai yang dirender. Elemen non-teks apa pun dalam rentang 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 dari bentuk atau sel tabel terkait ini.

Elemen AutoText seperti nomor slide yang dihasilkan dan elemen non-teks apa pun dalam rentang tersebut 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 {i>Shape<i} atau {i>TableCell<i} harus diakhiri dengan sebuah baris baru, baris baru terakhir di teks tidak 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 yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari rentang ke {i>clear<i}. Offset awal harus sama dengan atau lebih besar dari 0 dan kurang dari atau sama dengan endOffset. startOffset juga harus lebih kecil dari panjang rentang saat ini.
endOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks akhir eksklusif yang akan dibersihkan. endOffset harus sama dengan atau lebih besar dari startOffset. endOffset juga harus lebih kecil 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. Pencariannya adalah peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
patternStringPola ekspresi reguler untuk ditelusuri; setiap garis miring terbalik dalam pola seharusnya agar 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)

Mengembalikan 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 untuk ditelusuri; setiap garis miring terbalik dalam pola seharusnya agar di-escape.
startOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari rentang pencarian. startOffset harus juga 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 awal dan akhir indeks 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 mewakili satu tautan saja.

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

// Accesses the first link on a TextRange object.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var 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 rentang tempatnya berasal.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini 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 lebih kecil dari panjang rentang saat ini.
endOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks akhir eksklusif dari rentang yang dikembalikan. endOffset harus sama dengan atau lebih besar dari startOffset. endOffset juga harus lebih kecil 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 aliran teks yang tumpang-tindih dengan rentang teks saat ini. {i>Text run<i} adalah segmen teks di mana semua karakter memiliki gaya teks yang sama.

Setiap rentang yang ditampilkan hanya dijamin untuk mencakup satu rentang yang berjalan saat dibuat. Teks atau gaya modifikasi dapat menyebabkannya tidak lagi merepresentasikan dengan tepat satu proses.

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 inklusif berbasis 0 untuk karakter pertama dalam rentang ini. Jika awal dan indeks 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 di offset awal. Paragraf tersebut mempertahankan gaya visual saat ini rentang teks di offset awal.

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

Saat {i>string<i} teks yang disediakan berisi karakter baris baru (sehingga terdiri dari beberapa paragraf), paragraf terakhir yang ditambahkan akan ditampilkan.

Parameter

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

Pulang pergi

ParagraphParagraph 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 di offset awal.

Format teks yang disisipkan akan sesuai dengan format teks sumber.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari 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 di offset awal.

Jika disetel agar sesuai dengan format teks tujuan, AutoText dalam kolom rentang teks diganti dengan nilai yang dirender. Selanjutnya, setiap elemen non-teks di dalam rentang teks yang disediakan tidak dimasukkan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari teks yang akan disisipkan.
textRangeTextRangeRentang teks yang akan disisipkan.
matchSourceFormattingBooleanJika true, cocokkan dengan format teks sumber; jika false, cocok dengan format 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 di offset awal. Teks mempertahankan gaya teks yang ada pada offset awal.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari 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 sebaliknya.

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 contoh pencocokan teks temukan teks dengan teks pengganti. Penelusuran ini dilakukan tidak peka.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks untuk mengganti teks yang cocok.

Pulang pergi

Integer — jumlah kejadian berubah

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 contoh pencocokan teks temukan teks dengan teks pengganti.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks untuk mengganti teks yang cocok.
matchCaseBooleanJika true, penelusuran peka huruf besar/kecil; jika false, penelusurannya adalah peka huruf besar/kecil.

Pulang pergi

Integer — jumlah kejadian berubah

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 di presentasi aktif dan menghapus yang sebelumnya pilihan.

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 terdiri dari 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 ke indeks yang diinginkan.
      var 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