Class TextStyle

TextStyle

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getBackgroundColor()ColorMenampilkan warna latar belakang teks, atau null jika ada beberapa gaya pada teks.
getBaselineOffset()TextBaselineOffsetMenampilkan offset vertikal teks dari posisi normalnya, atau null jika ada beberapa gaya pada teks.
getFontFamily()StringMenampilkan jenis font teks, atau null jika ada beberapa gaya pada teks.
getFontSize()NumberMenampilkan ukuran font teks dalam titik, atau null jika ada beberapa gaya pada teks.
getFontWeight()IntegerMenampilkan ketebalan font teks, atau null jika ada beberapa gaya pada teks.
getForegroundColor()ColorMenampilkan warna latar depan teks, atau null jika ada beberapa gaya pada teks.
getLink()LinkMenampilkan Link pada teks, atau null jika tidak ada link, atau jika link ada di sebagian teks atau jika ada beberapa link.
hasLink()BooleanMenampilkan true jika ada link pada teks, false jika tidak, atau null jika link ada di bagian teks atau ada beberapa link.
isBackgroundTransparent()BooleanMenampilkan true jika latar belakang teks transparan, false jika tidak, atau null jika ada beberapa gaya pada teks.
isBold()BooleanMenampilkan true jika teks dirender dengan cetak tebal, false jika tidak, atau null jika ada beberapa gaya pada teks.
isItalic()BooleanMenampilkan true jika teks dicetak miring, false jika tidak, atau null jika ada beberapa gaya pada teks.
isSmallCaps()BooleanMenampilkan true jika teks menggunakan huruf besar kecil, false jika tidak, atau null jika ada beberapa gaya pada teks.
isStrikethrough()BooleanMenampilkan true jika teks dicoret, false jika tidak, atau null jika ada beberapa gaya pada teks.
isUnderline()BooleanMenampilkan true jika teks digarisbawahi, false jika tidak, atau null jika ada beberapa gaya pada teks.
removeLink()TextStyleMenghapus Link.
setBackgroundColor(color)TextStyleMenetapkan warna latar belakang teks.
setBackgroundColor(red, green, blue)TextStyleMenetapkan warna latar belakang teks ke nilai RGB yang diberikan dari 0 hingga 255.
setBackgroundColor(hexColor)TextStyleMenetapkan warna latar belakang teks ke string warna heksadesimal yang diberikan.
setBackgroundColor(color)TextStyleMenetapkan warna latar belakang teks ke ThemeColorType yang ditentukan.
setBackgroundColorTransparent()TextStyleMenyetel warna latar belakang teks menjadi transparan.
setBaselineOffset(offset)TextStyleMenyetel offset vertikal teks sesuai dengan posisi normalnya.
setBold(bold)TextStyleMenetapkan apakah teks harus dirender sebagai tebal.
setFontFamily(fontFamily)TextStyleMenetapkan jenis font teks .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleMenetapkan jenis font dan ketebalan teks.
setFontSize(fontSize)TextStyleMenetapkan ukuran font teks, dalam poin.
setForegroundColor(foregroundColor)TextStyleMenetapkan warna latar depan teks.
setForegroundColor(red, green, blue)TextStyleMenetapkan warna latar depan teks ke nilai RGB yang diberikan dari 0 hingga 255.
setForegroundColor(hexColor)TextStyleMenetapkan warna latar depan teks ke string warna heksadesimal yang diberikan.
setForegroundColor(color)TextStyleMenetapkan warna latar depan teks ke ThemeColorType yang ditentukan.
setItalic(italic)TextStyleMenetapkan apakah teks dicetak miring.
setLinkSlide(slideIndex)TextStyleMenetapkan Link ke Slide yang ditentukan menggunakan indeks slide yang berbasis nol.
setLinkSlide(slide)TextStyleMenetapkan Link ke Slide yang ditentukan, link ditetapkan oleh ID slide yang diberikan.
setLinkSlide(slidePosition)TextStyleMenetapkan Link ke Slide yang ditentukan menggunakan posisi relatif slide.
setLinkUrl(url)TextStyleMenetapkan Link ke string URL yang tidak kosong.
setSmallCaps(smallCaps)TextStyleMenetapkan apakah teks dirender dalam huruf besar kecil.
setStrikethrough(strikethrough)TextStyleMenetapkan apakah teks dicoret.
setUnderline(underline)TextStyleMenetapkan apakah teks digarisbawahi.

Dokumentasi mendetail

getBackgroundColor()

Menampilkan warna latar belakang teks, atau null jika ada beberapa gaya pada teks.

Return

Color

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

TextBaselineOffset

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

Color

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

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

Link

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

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

Menghapus Link.

Menghapus link akan menghapus warna latar depan hyperlink dan gaya garis bawah pada teks. Jika memungkinkan, gaya tersebut diterapkan agar sesuai dengan teks yang mendahului link. 

text.getTextStyle().removeLink();

Return

TextStyle

setBackgroundColor(color)

Menetapkan warna latar belakang teks.

Parameter

NamaJenisDeskripsi
colorColor

Return

TextStyle

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(red, green, blue)

Menetapkan warna latar belakang teks ke nilai RGB yang diberikan dari 0 hingga 255.

Parameter

NamaJenisDeskripsi
redInteger
greenInteger
blueInteger

Return

TextStyle

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

NamaJenisDeskripsi
hexColorString

Return

TextStyle

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

NamaJenisDeskripsi
colorThemeColorType

Return

TextStyle

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

Menyetel warna latar belakang teks menjadi transparan.

Return

TextStyle

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

setBaselineOffset(offset)

Menyetel offset vertikal teks sesuai dengan posisi normalnya.

Parameter

NamaJenisDeskripsi
offsetTextBaselineOffset

Return

TextStyle

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

NamaJenisDeskripsi
boldBoolean

Return

TextStyle

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

NamaJenisDeskripsi
fontFamilyString

Return

TextStyle

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

NamaJenisDeskripsi
fontFamilyString
fontWeightInteger

Return

TextStyle

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

NamaJenisDeskripsi
fontSizeNumber

Return

TextStyle

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

NamaJenisDeskripsi
foregroundColorColor

Return

TextStyle

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

NamaJenisDeskripsi
redInteger
greenInteger
blueInteger

Return

TextStyle

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

NamaJenisDeskripsi
hexColorString

Return

TextStyle

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

NamaJenisDeskripsi
colorThemeColorType

Return

TextStyle

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

NamaJenisDeskripsi
italicBoolean

Return

TextStyle

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

NamaJenisDeskripsi
slideIndexIntegerIndeks berbasis nol ke slide.

Return

TextStyle

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

NamaJenisDeskripsi
slideSlideSlide yang akan ditautkan.

Return

TextStyle

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

NamaJenisDeskripsi
slidePositionSlidePositionSlidePosition relatif.

Return

TextStyle

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

NamaJenisDeskripsi
urlStringString URL.

Return

TextStyle

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

NamaJenisDeskripsi
smallCapsBoolean

Return

TextStyle

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

NamaJenisDeskripsi
strikethroughBoolean

Return

TextStyle

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

NamaJenisDeskripsi
underlineBoolean

Return

TextStyle

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