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
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
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 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
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
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 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
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
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()
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.
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 disisipkan.
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