Class TextStyle

TextStyle

Gaya teks.

Metode baca di class ini menampilkan null jika TextRange yang sesuai mencakup span beberapa aliran teks, dan operasi tersebut memiliki nilai berbeda untuk metode baca yang dipanggil. Kepada hindari hal ini, buat kueri untuk gaya teks menggunakan TextRange yang ditampilkan oleh metode TextRange.getRuns().

Jika Anda menggunakan metode yang mengedit cara teks dipaskan dalam bentuk, setiap setelan paskan otomatis yang diterapkan gaya teks 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 poin, 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 di kolom teks.
getLink()LinkMenampilkan Link pada teks, atau null jika tidak ada link atau jika link aktif sebagian teks atau jika ada beberapa tautan.
hasLink()BooleanMenampilkan true jika ada link pada teks, false jika tidak, atau null jika tautan berada di bagian dari teks atau ada beberapa tautan.
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 sebagai 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 adalah beberapa gaya pada teks.
isSmallCaps()BooleanMenampilkan true jika teks dalam huruf kapital 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 adalah beberapa gaya pada teks.
removeLink()TextStyleMenghapus Link.
setBackgroundColor(color)TextStyleMenetapkan warna latar belakang teks.
setBackgroundColor(red, green, blue)TextStyleMenyetel 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 diberikan.
setBackgroundColorTransparent()TextStyleMenetapkan warna latar belakang teks menjadi transparan.
setBaselineOffset(offset)TextStyleMenetapkan offset vertikal teks relatif terhadap posisi normalnya.
setBold(bold)TextStyleMenetapkan apakah teks harus dirender sebagai tebal.
setFontFamily(fontFamily)TextStyleMenetapkan jenis font teks .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleMenetapkan jenis dan ketebalan font teks.
setFontSize(fontSize)TextStyleMenetapkan ukuran font teks, dalam poin.
setForegroundColor(foregroundColor)TextStyleMenetapkan warna latar depan teks.
setForegroundColor(red, green, blue)TextStyleMenyetel 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 diberikan menggunakan indeks berbasis nol dari slide.
setLinkSlide(slide)TextStyleMenetapkan Link ke Slide yang diberikan, link ditetapkan oleh ID slide yang diberikan.
setLinkSlide(slidePosition)TextStyleMenetapkan Link ke Slide yang diberikan menggunakan posisi relatif slide.
setLinkUrl(url)TextStyleMenetapkan Link ke string URL yang tidak kosong yang diberikan.
setSmallCaps(smallCaps)TextStyleMenetapkan apakah teks dirender dalam huruf besar kecil.
setStrikethrough(strikethrough)TextStyleMenetapkan apakah teks dicoret atau tidak.
setUnderline(underline)TextStyleMenetapkan apakah teks digarisbawahi.

Dokumentasi mendetail

getBackgroundColor()

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

Pulang pergi

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.

Pulang pergi

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.

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

getFontSize()

Menampilkan ukuran font teks dalam poin, atau null jika ada beberapa gaya pada teks.

Pulang pergi

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.

Beratnya 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, di dalam hal ini isBold() akan menampilkan true. Nilai defaultnya adalah 400 ("normal").

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

getForegroundColor()

Menampilkan warna latar depan teks, atau null jika ada beberapa gaya di kolom teks.

Pulang pergi

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 aktif teks atau jika ada banyak tautan. Panggil hasLink() untuk menentukan apakah teks tidak memiliki tautan. 

var textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log('Shape text has a link of type: ' + textLink.getLinkType());
}

Pulang pergi

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 tautan berada di bagian dari teks atau ada beberapa tautan.

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.

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

isBackgroundTransparent()

Menampilkan true jika latar belakang teks transparan, false jika tidak, atau null jika ada beberapa gaya pada teks.

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

isBold()

Menampilkan true jika teks dirender sebagai tebal, false jika tidak, atau null jika ada beberapa gaya pada teks.

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

isItalic()

Menampilkan true jika teks dicetak miring, false jika tidak, atau null jika ada adalah beberapa gaya pada teks.

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

isSmallCaps()

Menampilkan true jika teks dalam huruf kapital kecil, false jika tidak, atau null jika ada beberapa gaya pada teks.

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

isStrikethrough()

Menampilkan true jika teks dicoret, false jika tidak, atau null jika ada beberapa gaya pada teks.

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

isUnderline()

Menampilkan true jika teks digarisbawahi, false jika tidak, atau null jika ada adalah beberapa gaya pada teks.

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

Menghapus Link.

Menghapus link akan menghapus warna latar depan hyperlink dan gaya garis bawah pada teks. Jika memungkinkan, gaya ini diterapkan agar sesuai dengan teks sebelum tautan. 

text.getTextStyle().removeLink();

Pulang pergi

TextStyle

setBackgroundColor(color)

Menetapkan warna latar belakang teks.

Parameter

NamaJenisDeskripsi
colorColor

Pulang pergi

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)

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

Parameter

NamaJenisDeskripsi
redInteger
greenInteger
blueInteger

Pulang pergi

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 heksadesimal harus dalam format '#RRGGBB'. Misalnya, merah muda akan direpresentasikan sebagai '#FFC0CB'.

Parameter

NamaJenisDeskripsi
hexColorString

Pulang pergi

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 diberikan.

Parameter

NamaJenisDeskripsi
colorThemeColorType

Pulang pergi

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

Menetapkan warna latar belakang teks menjadi transparan.

Pulang pergi

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)

Menetapkan offset vertikal teks relatif terhadap posisi normalnya.

Parameter

NamaJenisDeskripsi
offsetTextBaselineOffset

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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 dan ketebalan font teks.

Bobotnya 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, di dalam hal ini isBold() akan menampilkan true. Nilai defaultnya adalah 400 ("normal").

Parameter

NamaJenisDeskripsi
fontFamilyString
fontWeightInteger

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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)

Menyetel warna latar depan teks ke nilai RGB yang diberikan dari 0 hingga 255.

Parameter

NamaJenisDeskripsi
redInteger
greenInteger
blueInteger

Pulang pergi

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 heksadesimal harus dalam format '#RRGGBB'. Misalnya, merah muda akan direpresentasikan sebagai '#FFC0CB'.

Parameter

NamaJenisDeskripsi
hexColorString

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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 diberikan menggunakan indeks berbasis nol dari slide.

Menyetel link akan mengubah gaya teks yang digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Nama 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.

Pulang pergi

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 diberikan, link ditetapkan oleh ID slide yang diberikan.

Menyetel link akan mengubah gaya teks yang digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Nama 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.

Pulang pergi

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 diberikan menggunakan posisi relatif slide.

Menyetel link akan mengubah gaya teks yang digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Nama 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.

Pulang pergi

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 yang diberikan.

Menyetel link akan mengubah gaya teks yang digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Nama 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.

Pulang pergi

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

Pulang pergi

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 atau tidak.

Parameter

NamaJenisDeskripsi
strikethroughBoolean

Pulang pergi

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

Pulang pergi

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