Gaya teks.
Metode baca di class ini menampilkan null
jika TextRange
yang sesuai mencakup beberapa teks yang berjalan, dan metode tersebut memiliki nilai yang berbeda untuk metode baca yang dipanggil. Untuk
menghindarinya, buat kueri untuk gaya teks menggunakan TextRange
yang ditampilkan oleh metode TextRange.getRuns()
.
Jika Anda menggunakan metode yang mengedit cara teks dipaskan dalam bentuk, setelan paskan otomatis apa pun yang diterapkan ke gaya teks akan dinonaktifkan.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getBackgroundColor() | Color | Menampilkan warna latar belakang teks, atau null jika ada beberapa gaya pada teks. |
getBaselineOffset() | TextBaselineOffset | Menampilkan offset vertikal teks dari posisi normalnya, atau null jika ada
beberapa gaya pada teks. |
getFontFamily() | String | Menampilkan jenis font teks, atau null jika ada beberapa gaya pada teks. |
getFontSize() | Number | Menampilkan ukuran font teks dalam titik, atau null jika ada beberapa gaya pada teks. |
getFontWeight() | Integer | Menampilkan ketebalan font teks, atau null jika ada beberapa gaya pada teks. |
getForegroundColor() | Color | Menampilkan warna latar depan teks, atau null jika ada beberapa gaya pada
teks. |
getLink() | Link | Menampilkan Link pada teks, atau null jika tidak ada link, atau jika link ada di sebagian teks atau jika ada beberapa link. |
hasLink() | Boolean | Menampilkan true jika ada link pada teks, false jika tidak, atau null jika link ada di bagian teks atau ada beberapa link. |
isBackgroundTransparent() | Boolean | Menampilkan true jika latar belakang teks transparan, false jika tidak, atau
null jika ada beberapa gaya pada teks. |
isBold() | Boolean | Menampilkan true jika teks dirender dengan cetak tebal, false jika tidak, atau null jika
ada beberapa gaya pada teks. |
isItalic() | Boolean | Menampilkan true jika teks dicetak miring, false jika tidak, atau null jika ada
beberapa gaya pada teks. |
isSmallCaps() | Boolean | Menampilkan true jika teks menggunakan huruf besar kecil, false jika tidak, atau null jika ada beberapa gaya pada teks. |
isStrikethrough() | Boolean | Menampilkan true jika teks dicoret, false jika tidak, atau null jika ada beberapa gaya pada teks. |
isUnderline() | Boolean | Menampilkan true jika teks digarisbawahi, false jika tidak, atau null jika ada
beberapa gaya pada teks. |
removeLink() | TextStyle | Menghapus Link . |
setBackgroundColor(color) | TextStyle | Menetapkan warna latar belakang teks. |
setBackgroundColor(red, green, blue) | TextStyle | Menetapkan warna latar belakang teks ke nilai RGB yang diberikan dari 0 hingga 255. |
setBackgroundColor(hexColor) | TextStyle | Menetapkan warna latar belakang teks ke string warna heksadesimal yang diberikan. |
setBackgroundColor(color) | TextStyle | Menetapkan warna latar belakang teks ke ThemeColorType yang ditentukan. |
setBackgroundColorTransparent() | TextStyle | Menyetel warna latar belakang teks menjadi transparan. |
setBaselineOffset(offset) | TextStyle | Menyetel offset vertikal teks sesuai dengan posisi normalnya. |
setBold(bold) | TextStyle | Menetapkan apakah teks harus dirender sebagai tebal. |
setFontFamily(fontFamily) | TextStyle | Menetapkan jenis font teks . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Menetapkan jenis font dan ketebalan teks. |
setFontSize(fontSize) | TextStyle | Menetapkan ukuran font teks, dalam poin. |
setForegroundColor(foregroundColor) | TextStyle | Menetapkan warna latar depan teks. |
setForegroundColor(red, green, blue) | TextStyle | Menetapkan warna latar depan teks ke nilai RGB yang diberikan dari 0 hingga 255. |
setForegroundColor(hexColor) | TextStyle | Menetapkan warna latar depan teks ke string warna heksadesimal yang diberikan. |
setForegroundColor(color) | TextStyle | Menetapkan warna latar depan teks ke ThemeColorType yang ditentukan. |
setItalic(italic) | TextStyle | Menetapkan apakah teks dicetak miring. |
setLinkSlide(slideIndex) | TextStyle | Menetapkan Link ke Slide yang ditentukan menggunakan indeks slide yang berbasis nol. |
setLinkSlide(slide) | TextStyle | Menetapkan Link ke Slide yang ditentukan, link ditetapkan oleh ID slide yang diberikan. |
setLinkSlide(slidePosition) | TextStyle | Menetapkan Link ke Slide yang ditentukan menggunakan posisi relatif slide. |
setLinkUrl(url) | TextStyle | Menetapkan Link ke string URL yang tidak kosong. |
setSmallCaps(smallCaps) | TextStyle | Menetapkan apakah teks dirender dalam huruf besar kecil. |
setStrikethrough(strikethrough) | TextStyle | Menetapkan apakah teks dicoret. |
setUnderline(underline) | TextStyle | Menetapkan apakah teks digarisbawahi. |
Dokumentasi mendetail
getBackgroundColor()
Menampilkan warna latar belakang teks, atau null
jika ada beberapa gaya pada teks.
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
getBaselineOffset()
Menampilkan offset vertikal teks dari posisi normalnya, atau null
jika ada
beberapa gaya pada teks.
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
getFontFamily()
Menampilkan jenis font teks, atau null
jika ada beberapa gaya pada teks.
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
getFontSize()
Menampilkan ukuran font teks dalam titik, atau null
jika ada beberapa gaya pada teks.
Return
Number
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
getFontWeight()
Menampilkan ketebalan font teks, atau null
jika ada beberapa gaya pada teks.
Bobot tersebut adalah kelipatan 100 antara 100 dan 900, inklusif. Rentang ini sesuai dengan
nilai numerik yang dijelaskan dalam Spesifikasi CSS 2.1, bagian 15.6, dengan
nilai non-numerik tidak diizinkan. Bobot yang lebih besar dari atau sama dengan 700 dianggap tebal, jika isBold()
menampilkan true
. Nilai defaultnya adalah 400
("normal").
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
getForegroundColor()
Menampilkan warna latar depan teks, atau null
jika ada beberapa gaya pada
teks.
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
getLink()
Menampilkan Link
pada teks, atau null
jika tidak ada link, atau jika link ada di sebagian teks atau jika ada beberapa link. Panggil hasLink()
untuk menentukan apakah
teks tidak memiliki link.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
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
hasLink()
Menampilkan true
jika ada link pada teks, false
jika tidak, atau null
jika link ada di bagian teks atau ada beberapa link.
Link tidak dapat ditetapkan pada karakter baris baru. Oleh karena itu, jika TextRange
berisi
karakter baris baru, metode ini akan selalu menampilkan null
atau false
.
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
isBackgroundTransparent()
Menampilkan true
jika latar belakang teks transparan, false
jika tidak, atau
null
jika ada beberapa gaya pada teks.
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
isBold()
Menampilkan true
jika teks dirender dengan cetak tebal, false
jika tidak, atau null
jika
ada beberapa gaya pada teks.
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
isItalic()
Menampilkan true
jika teks dicetak miring, false
jika tidak, atau null
jika ada
beberapa gaya pada teks.
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
isSmallCaps()
Menampilkan true
jika teks menggunakan huruf besar kecil, false
jika tidak, atau null
jika ada beberapa gaya pada teks.
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
isStrikethrough()
Menampilkan true
jika teks dicoret, false
jika tidak, atau null
jika ada beberapa gaya pada teks.
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
isUnderline()
Menampilkan true
jika teks digarisbawahi, false
jika tidak, atau null
jika ada
beberapa gaya pada teks.
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
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
Menetapkan warna latar belakang teks ke nilai RGB yang diberikan dari 0 hingga 255.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
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
setBackgroundColor(hexColor)
Menetapkan warna latar belakang teks ke string warna heksadesimal yang diberikan.
String hex harus dalam format '#RRGGBB'. Misalnya, merah muda akan direpresentasikan '#FFC0CB'.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
hexColor | String |
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
setBackgroundColor(color)
Menetapkan warna latar belakang teks ke ThemeColorType
yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | ThemeColorType |
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
setBackgroundColorTransparent()
setBaselineOffset(offset)
Menyetel offset vertikal teks sesuai dengan posisi normalnya.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
offset | TextBaselineOffset |
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
setBold(bold)
Menetapkan apakah teks harus dirender sebagai tebal.
Mengubah ketebalan teks akan memperbarui ketebalan font yang digunakan untuk merender teks.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
bold | Boolean |
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
setFontFamily(fontFamily)
Menetapkan jenis font teks .
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
fontFamily | String |
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
setFontFamilyAndWeight(fontFamily, fontWeight)
Menetapkan jenis font dan ketebalan teks.
Bobot tersebut adalah kelipatan 100 antara 100 dan 900, inklusif. Rentang ini sesuai dengan
nilai numerik yang dijelaskan dalam Spesifikasi CSS 2.1, bagian 15.6, dengan
nilai non-numerik tidak diizinkan. Bobot yang lebih besar dari atau sama dengan 700 dianggap tebal, jika isBold()
menampilkan true
. Nilai defaultnya adalah 400
("normal").
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
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
setFontSize(fontSize)
Menetapkan ukuran font teks, dalam poin.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
fontSize | Number |
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
setForegroundColor(foregroundColor)
Menetapkan warna latar depan teks.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
foregroundColor | Color |
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
setForegroundColor(red, green, blue)
Menetapkan warna latar depan teks ke nilai RGB yang diberikan dari 0 hingga 255.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
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
setForegroundColor(hexColor)
Menetapkan warna latar depan teks ke string warna heksadesimal yang diberikan.
String hex harus dalam format '#RRGGBB'. Misalnya, merah muda akan direpresentasikan '#FFC0CB'.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
hexColor | String |
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
setForegroundColor(color)
Menetapkan warna latar depan teks ke ThemeColorType
yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | ThemeColorType |
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
setItalic(italic)
Menetapkan apakah teks dicetak miring.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
italic | Boolean |
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
setLinkSlide(slideIndex)
Menetapkan Link
ke Slide
yang ditentukan menggunakan indeks slide yang berbasis nol.
Menyetel link akan mengubah gaya teks menjadi digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK
. Setelan ini dapat diubah melalui setForegroundColor(hexColor)
dan setUnderline(underline)
.
Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru dalam TextRange
akan diabaikan.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slideIndex | Integer | Indeks berbasis nol ke slide. |
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
setLinkSlide(slide)
Menetapkan Link
ke Slide
yang ditentukan, link ditetapkan oleh ID slide yang diberikan.
Menyetel link akan mengubah gaya teks menjadi digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK
. Setelan ini dapat diubah melalui setForegroundColor(hexColor)
dan setUnderline(underline)
.
Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru dalam TextRange
akan diabaikan.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; text.getTextStyle().setLinkSlide(slide);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slide | Slide | Slide yang akan ditautkan. |
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
setLinkSlide(slidePosition)
Menetapkan Link
ke Slide
yang ditentukan menggunakan posisi relatif slide.
Menyetel link akan mengubah gaya teks menjadi digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK
. Setelan ini dapat diubah melalui setForegroundColor(hexColor)
dan setUnderline(underline)
.
Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru dalam TextRange
akan diabaikan.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slidePosition | SlidePosition | SlidePosition relatif. |
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
setLinkUrl(url)
Menetapkan Link
ke string URL yang tidak kosong.
Menyetel link akan mengubah gaya teks menjadi digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK
. Setelan ini dapat diubah melalui setForegroundColor(hexColor)
dan setUnderline(underline)
.
Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru dalam TextRange
akan diabaikan.
// Set a link to the URL. text.getTextStyle().setLinkUrl("https://slides.google.com");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | String URL. |
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
setSmallCaps(smallCaps)
Menetapkan apakah teks dirender dalam huruf besar kecil.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
smallCaps | Boolean |
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
setStrikethrough(strikethrough)
Menetapkan apakah teks dicoret.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
strikethrough | Boolean |
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
setUnderline(underline)
Menetapkan apakah teks digarisbawahi.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
underline | Boolean |
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