Anda dapat mengedit dan memberi gaya teks menggunakan rentang teks, yang direpresentasikan oleh
jenis TextRange
. TextRange
mewakili segmen teks dalam suatu bentuk atau
dalam sel tabel. Memanggil getText()
pada bentuk atau sel tabel akan menampilkan
rentang teks yang mencakup seluruh teks.
Jika Anda menggunakan metode yang mengedit cara teks dipaskan dalam bentuk, setelan paskan otomatis yang diterapkan ke bentuk akan dinonaktifkan.
Menggunakan rentang teks
Rentang teks memiliki dua indeks yang membatasi segmen teks yang dicakup oleh suatu rentang teks: indeks awal dan indeks akhir. Anda dapat menentukan indeks ini menggunakan fungsi getStartIndex()
dan getEndIndex()
.
Untuk membaca konten rentang teks, gunakan fungsi asString()
atau
asRenderedString()
.
Untuk mengambil subrentang dari dalam rentang teks, gunakan fungsi getRange()
.
Skrip berikut membuat kotak teks pada slide pertama dan menetapkan konten teksnya ke "Hello world!". Tindakan ini kemudian mengambil subrentang yang hanya mencakup "Hello".
Rentang teks yang ditampilkan oleh bentuk atau sel tabel akan selalu mencakup seluruh teks, meskipun teks disisipkan dan dihapus. Jadi, contoh di atas menghasilkan laporan log berikut:
Start: 0; End: 13; Content: Hello world! Start: 0; End: 5; Content: Hello
Menyisipkan dan menghapus teks
Anda juga dapat menyisipkan dan menghapus bentuk teks dan sel tabel menggunakan rentang teks.
insertText()
danappendText()
memungkinkan Anda menyisipkan teks.setText()
mengganti teks rentang teks dengan teks yang disediakan.clear()
menghapus teks dari dalam rentang teks.
Skrip berikut menunjukkan penggunaan fungsi ini:
Skrip ini membuat kotak teks pada slide pertama dan menetapkan konten teksnya ke "Hello world!". Kemudian, kode ini menghapus karakter 6 sampai 11 ("dunia"), dan menyisipkan teks "galaksi" pada indeks 6. Contoh di atas menghasilkan laporan log berikut:
Start: 0; End: 14; Content: Hello galaxy!
Telusuri dan ganti
Gunakan fungsi replaceAllText()
pada presentasi atau halaman untuk melakukan
cari dan penggantian global di seluruh presentasi atau halaman tertentu.
Fungsi find()
pada TextRange menampilkan instance string dalam
rentang. Fungsi ini dapat digunakan bersama dengan setText()
untuk melakukan pencarian dan penggantian
dalam bentuk atau sel tabel.
Paragraf, item daftar, dan operasi
TextRange
menyediakan fungsi untuk menampilkan koleksi entity teks yang berguna.
Beberapa fungsi ini mencakup:
getParagraphs(),
yang menyediakan semua paragraf yang tumpang-tindih dengan rentang teks. Paragraf adalah urutan teks yang diakhiri dengan karakter baris baru, "\n".getListParagraphs(),
yang menampilkan item daftar dalam rentang teks saat ini.getRuns(),
yang menyediakan teks yang tumpang-tindih dengan rentang teks saat ini. Operasi teks adalah segmen teks yang semua karakternya memiliki gaya teks yang sama.
Gaya teks
Gaya teks menentukan rendering karakter teks dalam presentasi Anda, termasuk font, warna, dan pembuatan hyperlink.
Fungsi getTextStyle()
dari rentang teks menyediakan objek TextStyle
yang digunakan untuk menata gaya teks. Objek TextStyle
mencakup teks yang sama dengan induknya, TextRange
.
Contoh di atas terlebih dahulu membuat kotak teks pada slide pertama dan menetapkan
kontennya ke "Hello ". Kemudian teks "world!" ditambahkan. Teks yang baru ditambahkan
akan dicetak tebal, ditautkan ke www.example.com
, dan warnanya disetel
ke merah.
Saat membaca gaya, fungsi ini akan menampilkan null jika rentang memiliki beberapa nilai untuk gaya tersebut. Jadi, contoh di atas menghasilkan laporan log berikut:
Text: Hello; Bold: false Text: world!; Bold: true Text: Hello world!; Bold: null
Ada banyak gaya lain yang dapat diterapkan pada teks. Detail selengkapnya dapat
ditemukan dalam dokumentasi referensi TextStyle
.
Gaya paragraf
Gaya paragraf berlaku untuk seluruh paragraf, dan mencakup hal-hal seperti perataan teks dan spasi
baris. Fungsi getParagraphStyle() di TextRange
menyediakan objek ParagraphStyle
untuk menata gaya semua paragraf yang tumpang-tindih dengan rentang teks induk.
Contoh berikut membuat kotak teks pada slide pertama dengan empat paragraf, lalu meratakan tengah tiga paragraf pertama.
Gaya daftar
Serupa dengan ParagraphStyle
, ListStyle
dapat digunakan untuk menata gaya semua paragraf
yang tumpang-tindih dengan rentang teks induk.
Contoh di atas membuat kotak teks pada slide pertama, yang berisi empat paragraf: paragraf kedua diindentasi satu kali dan paragraf ketiga diindentasi dua kali. Kemudian menerapkan preset daftar ke semua paragraf. Terakhir, setiap tingkat bertingkat paragraf di log. (Tingkat penyusunan bertingkat paragraf berasal dari jumlah tab sebelum teks paragraf.) Jadi, skrip di atas menghasilkan laporan log berikut:
Paragraph 1's nesting level: 0 Paragraph 2's nesting level: 1 Paragraph 3's nesting level: 2 Paragraph 4's nesting level: 0