Halaman ini diterjemahkan oleh Cloud Translation API.

Class TextRange

Segmen konten teks Shape atau TableCell.

Jika Anda menggunakan metode yang mengedit kecocokan teks dengan bentuk, setelan paskan otomatis yang diterapkan pada bentuk akan dinonaktifkan.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`appendParagraph(text)`	`Paragraph`	Menambahkan paragraf di akhir rentang teks.
`appendRange(textRange)`	`TextRange`	Menambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Menambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.
`appendText(text)`	`TextRange`	Menambahkan teks di akhir rentang teks.
`asRenderedString()`	`String`	Menampilkan teks yang dirender yang dibatasi oleh rentang bentuk atau sel tabel terkait ini dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.
`asString()`	`String`	Menampilkan teks mentah yang dibatasi oleh rentang bentuk atau sel tabel terkait ini.
`clear()`	`void`	Menghapus teks yang dibatasi oleh rentang ini.
`clear(startOffset, endOffset)`	`void`	Menghapus 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 yang dimulai dari offset awal.
`getAutoTexts()`	`AutoText[]`	Menampilkan teks otomatis dalam rentang teks saat ini.
`getEndIndex()`	`Integer`	Menampilkan indeks berbasis 0 eksklusif untuk karakter terakhir dalam rentang ini.
`getLength()`	`Integer`	Menampilkan 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()`	`ListStyle`	Menampilkan `ListStyle` dari rentang teks saat ini.
`getParagraphStyle()`	`ParagraphStyle`	Menampilkan `ParagraphStyle` dari rentang teks saat ini.
`getParagraphs()`	`Paragraph[]`	Menampilkan paragraf yang tumpang tindih dengan rentang teks saat ini.
`getRange(startOffset, endOffset)`	`TextRange`	Menampilkan `TextRange` baru yang mencakup bagian rentang tempat asalnya.
`getRuns()`	`TextRange[]`	Menampilkan teks yang berjalan yang tumpang tindih dengan rentang teks saat ini.
`getStartIndex()`	`Integer`	Menampilkan indeks berbasis 0 yang inklusif untuk karakter pertama dalam rentang ini.
`getTextStyle()`	`TextStyle`	Menampilkan gaya teks rentang, atau `null` jika rentang kosong.
`insertParagraph(startOffset, text)`	`Paragraph`	Menyisipkan paragraf di offset awal.
`insertRange(startOffset, textRange)`	`TextRange`	Menyisipkan salinan rentang teks yang disediakan di offset awal.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Menyisipkan salinan rentang teks yang disediakan di offset awal.
`insertText(startOffset, text)`	`TextRange`	Menyisipkan teks pada offset awal.
`isEmpty()`	`Boolean`	Menampilkan `true` jika tidak ada karakter dalam rentang ini, dan menampilkan `false` jika tidak.
`replaceAllText(findText, replaceText)`	`Integer`	Menggantikan semua instance teks yang cocok menemukan teks dengan mengganti teks.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Menggantikan semua instance teks yang cocok menemukan teks dengan mengganti teks.
`select()`	`void`	Memilih `TextRange` dalam presentasi aktif saja dan menghapus pemilihan sebelumnya.
`setText(newText)`	`TextRange`	Menetapkan 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 disediakan berisi karakter baris baru (sehingga terdiri dari beberapa paragraf), paragraf akhir yang ditambahkan akan ditampilkan.

Parameter

Name	Jenis	Deskripsi
`text`	`String`	String yang akan ditambahkan sebagai paragraf.

Return

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 teks sumber.

Parameter

Name	Jenis	Deskripsi
`textRange`	`TextRange`	Rentang teks yang akan ditambahkan.

Return

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 cocok dengan format teks tujuan, AutoText dalam rentang teks yang diberikan akan diganti dengan nilai yang dirender. Selain itu, elemen non-teks dalam rentang teks yang disediakan tidak ditambahkan.

Parameter

Name	Jenis	Deskripsi
`textRange`	`TextRange`	Rentang teks yang akan ditambahkan.
`matchSourceFormatting`	`Boolean`	Jika `true`, cocokkan dengan format teks sumber; jika `false`, cocokkan dengan format teks tujuan.

Return

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

Name	Jenis	Deskripsi
`text`	`String`	String yang akan ditambahkan.

Return

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 ini dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.

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

Return

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 bentuk atau sel tabel terkait ini.

Elemen AutoText seperti nomor slide yang dihasilkan dan elemen non-teks dalam rentang diganti dengan karakter Unicode U+E907.

Return

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 akhir dalam teks tidak akan dihapus meskipun ditutupi oleh offset yang ditentukan.

Parameter

Name	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal rentang yang akan dihapus. 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.
`endOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks akhir eksklusif dari 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

Name	Jenis	Deskripsi
`pattern`	`String`	Pola ekspresi reguler yang akan ditelusuri; semua garis miring terbalik dalam pola harus di-escape.

Return

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 yang dimulai dari offset awal. Penelusuran peka huruf besar/kecil.

Parameter

Name	Jenis	Deskripsi
`pattern`	`String`	Pola ekspresi reguler yang akan ditelusuri; semua garis miring terbalik dalam pola harus di-escape.
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal rentang yang akan ditelusuri. `startOffset` juga harus kurang dari panjang rentang saat ini.

Return

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.

Return

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 berbasis 0 eksklusif untuk karakter terakhir dalam rentang ini. Jika indeks awal dan akhir sama, rentang dianggap kosong.

Return

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.

Return

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

`getLinks()`

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. Perubahan teks dapat menyebabkannya tidak lagi mewakili satu link secara tepat.

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

Return

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.

Return

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.

Return

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.

Return

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.

Return

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 tempat asalnya.

Parameter

Name	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah 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 lebih kecil dari panjang rentang saat ini.
`endOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks akhir eksklusif dari rentang yang ditampilkan. `endOffset` harus sama dengan atau lebih besar dari `startOffset`. `endOffset` juga harus kurang dari atau sama dengan panjang rentang saat ini.

Return

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 teks yang berjalan yang tumpang tindih dengan rentang teks saat ini. Operasi teks adalah segmen teks dengan semua karakter memiliki gaya teks yang sama.

Setiap rentang yang ditampilkan hanya dijamin untuk mencakup satu rentang saat dibuat. Modifikasi teks atau gaya dapat menyebabkannya tidak lagi mewakili satu proses saja.

Return

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.

Return

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.

Return

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 mempertahankan gaya rentang teks saat ini pada offset awal.

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

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

Parameter

Name	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
`text`	`String`	String yang akan dimasukkan.

Return

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

Format teks yang disisipkan akan cocok dengan teks sumber.

Parameter

Name	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
`textRange`	`TextRange`	Rentang teks yang akan disisipkan.

Return

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.

Parameter

Name	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
`textRange`	`TextRange`	Rentang teks yang akan disisipkan.
`matchSourceFormatting`	`Boolean`	Jika `true`, cocokkan dengan format teks sumber; jika `false`, cocokkan dengan format teks tujuan.

Return

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 visual teks yang ada di offset awal.

Parameter

Name	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
`text`	`String`	String yang akan dimasukkan.

Return

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.

Return

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)`

Menggantikan semua instance teks yang cocok menemukan teks dengan mengganti teks. Penelusuran tidak peka huruf besar/kecil.

Parameter

Name	Jenis	Deskripsi
`findText`	`String`	Teks yang akan ditemukan.
`replaceText`	`String`	Teks untuk menggantikan teks yang cocok.

Return

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)`

Menggantikan semua instance teks yang cocok menemukan teks dengan mengganti teks.

Parameter

Name	Jenis	Deskripsi
`findText`	`String`	Teks yang akan ditemukan.
`replaceText`	`String`	Teks untuk menggantikan teks yang cocok.
`matchCase`	`Boolean`	Jika `true`, penelusuran peka huruf besar/kecil; jika `false`, penelusuran tidak peka huruf besar/kecil.

Return

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()`

Memilih TextRange dalam presentasi aktif saja dan menghapus pemilihan sebelumnya.

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

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

Selection dapat berupa salah satu dari dua jenis berikut:

1. Rentang teks, gunakan pilihan pada TextRange yang tidak kosong untuk memilih rentang karakter.

2. Posisi kursor, gunakan TextRange kosong untuk menempatkan kursor pada 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 visual awal teks yang ada.

Parameter

Name	Jenis	Deskripsi
`newText`	`String`	String yang akan ditetapkan sebagai teks baru.

Return

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