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
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 hasil render yang dibatasi oleh rentang bentuk atau sel tabel terkait dalam format yang sesuai untuk ditampilkan kepada pengguna akhir. |
asString() | String | Menampilkan teks mentah yang dibatasi oleh rentang dari 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[] | 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() | 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 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 tempatnya berasal. |
getRuns() | TextRange[] | Menampilkan aliran 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
sebaliknya. |
replaceAllText(findText, replaceText) | Integer | Mengganti semua contoh pencocokan teks temukan teks dengan teks pengganti. |
replaceAllText(findText, replaceText, matchCase) | Integer | Mengganti semua contoh pencocokan teks temukan teks dengan teks pengganti. |
select() | void | Hanya memilih TextRange di presentasi aktif dan menghapus yang sebelumnya
pilihan. |
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 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
Nama | Jenis | Deskripsi |
---|---|---|
text | String | String yang akan ditambahkan sebagai paragraf. |
Pulang pergi
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 sesuai dengan format teks sumber.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
textRange | TextRange | Rentang 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
Nama | Jenis | Deskripsi |
---|---|---|
textRange | TextRange | Rentang teks yang akan ditambahkan. |
matchSourceFormatting | Boolean | Jika 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
Nama | Jenis | Deskripsi |
---|---|---|
text | String | String 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
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Jumlah 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. |
endOffset | Integer | Jumlah 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
Nama | Jenis | Deskripsi |
---|---|---|
pattern | String | Pola ekspresi reguler untuk ditelusuri; setiap garis miring terbalik dalam pola seharusnya agar di-escape. |
Pulang pergi
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
Nama | Jenis | Deskripsi |
---|---|---|
pattern | String | Pola ekspresi reguler untuk ditelusuri; setiap garis miring terbalik dalam pola seharusnya agar di-escape. |
startOffset | Integer | Jumlah 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
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
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
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. 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
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
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.
Pulang pergi
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
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
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Jumlah 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. |
endOffset | Integer | Jumlah 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
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
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()
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
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Jumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari teks yang akan disisipkan. |
text | String | String yang akan disisipkan. |
Pulang pergi
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 yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari teks yang akan disisipkan. |
textRange | TextRange | Rentang 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
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Jumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini 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 , 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
Nama | Jenis | Deskripsi |
---|---|---|
startOffset | Integer | Jumlah karakter yang melewati indeks awal rentang teks yang digunakan saat ini untuk menentukan indeks awal inklusif dari teks yang akan disisipkan. |
text | String | String 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
Nama | Jenis | Deskripsi |
---|---|---|
findText | String | Teks yang akan dicari. |
replaceText | String | Teks 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
Nama | Jenis | Deskripsi |
---|---|---|
findText | String | Teks yang akan dicari. |
replaceText | String | Teks untuk mengganti teks yang cocok. |
matchCase | Boolean | Jika 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
Nama | Jenis | Deskripsi |
---|---|---|
newText | String | String 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