Halaman ini diterjemahkan oleh Cloud Translation API.

Class TextRange

Segmen konten teks Shape atau TableCell.

Jika Anda menggunakan metode yang mengedit cara teks dipaskan dalam suatu bentuk, setelan paskan otomatis apa pun yang diterapkan ke 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 disediakan ke akhir rentang teks saat ini.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Menambahkan salinan rentang teks yang disediakan 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 yang terkait ini dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.
`asString()`	`String`	Menampilkan teks mentah yang dibatasi oleh rentang bentuk atau sel tabel yang 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, mulai dari offset awal.
`getAutoTexts()`	`AutoText[]`	Menampilkan teks otomatis dalam rentang teks saat ini.
`getEndIndex()`	`Integer`	Menampilkan indeks eksklusif berbasis 0 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` rentang teks saat ini.
`getParagraphStyle()`	`ParagraphStyle`	Menampilkan `ParagraphStyle` 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 asalnya.
`getRuns()`	`TextRange[]`	Menampilkan deret teks yang tumpang-tindih dengan rentang teks saat ini.
`getStartIndex()`	`Integer`	Menampilkan indeks inklusif berbasis 0 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 di offset awal.
`isEmpty()`	`Boolean`	Menampilkan `true` jika tidak ada karakter dalam rentang ini, dan menampilkan `false` jika tidak.
`replaceAllText(findText, replaceText)`	`Integer`	Mengganti semua kasus pencocokan teks yang cocok dengan teks yang dicari.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Mengganti semua kasus pencocokan teks yang cocok dengan teks yang dicari.
`select()`	`void`	Hanya memilih `TextRange` di presentasi aktif dan menghapus pilihan sebelumnya.
`setText(newText)`	`TextRange`	Menetapkan teks yang dibatasi oleh rentang bentuk atau sel tabel yang terkait ini.

Dokumentasi mendetail

`appendParagraph(text)`

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

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

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

Parameter

Nama	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 disediakan ke akhir rentang teks saat ini.

Format teks yang disisipkan akan sesuai dengan format teks sumber.

Parameter

Nama	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 disediakan ke akhir rentang teks saat ini.

Jika ditetapkan agar cocok dengan format 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 ditambahkan.

Parameter

Nama	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

Nama	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 yang terkait ini 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 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 yang 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 terakhir dalam teks tidak akan dihapus meskipun tercakup oleh offset yang diberikan.

Parameter

Nama	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif dari 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.
`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. Pencarian bersifat peka huruf besar/kecil.

Parameter

Nama	Jenis	Deskripsi
`pattern`	`String`	Pola ekspresi reguler untuk melakukan penelusuran; setiap 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, mulai dari offset awal. Penelusuran peka huruf besar/kecil.

Parameter

Nama	Jenis	Deskripsi
`pattern`	`String`	Pola ekspresi reguler untuk melakukan penelusuran; setiap 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 inklusif dari 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 eksklusif berbasis 0 untuk karakter terakhir dalam rentang ini. Jika indeks awal dan akhir sama, rentang ini 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 akan mencakup satu link saat dibuat. Modifikasi teks dapat menyebabkannya tidak lagi merepresentasikan hanya satu link.

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

Parameter

Nama	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 kurang 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 deret teks yang tumpang-tindih dengan rentang teks saat ini. {i>Text run<i} adalah segmen teks di mana semua karakternya memiliki gaya teks yang sama.

Setiap rentang yang ditampilkan hanya dijamin untuk span satu run saat dibuat. Modifikasi teks atau gaya dapat menyebabkannya tidak lagi merepresentasikan dengan tepat satu run.

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 inklusif berbasis 0 untuk karakter pertama dalam rentang ini. Jika indeks awal dan akhir sama, rentang ini 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 penataan gaya rentang teks saat ini pada offset awal.

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

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

Parameter

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

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 sesuai dengan format teks sumber.

Parameter

Nama	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif dari 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

Nama	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif dari 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 di offset awal. Teks mempertahankan gaya teks yang ada di offset awal.

Parameter

Nama	Jenis	Deskripsi
`startOffset`	`Integer`	Jumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif dari teks yang akan disisipkan.
`text`	`String`	String 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

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

Mengganti semua kasus pencocokan teks yang cocok dengan teks yang dicari. Pencarian tidak peka huruf besar/kecil.

Parameter

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

Return

Integer — jumlah kemunculan yang 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 kasus pencocokan teks yang cocok dengan teks yang dicari.

Parameter

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

Return

Integer — jumlah kemunculan yang 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 pilihan sebelumnya.

Skrip hanya dapat mengakses pemilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke 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 salah satu dari dua jenis berikut:

1. Rentang teks, gunakan select 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 yang terkait ini. Teks mempertahankan gaya awal teks yang ada.

Parameter

Nama	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