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
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
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
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
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
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()
getParagraphStyle()
Menampilkan ParagraphStyle
dari rentang teks saat ini.
Return
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
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
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
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()
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.
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 disisipkan.
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