Class TextStyle

GayaTeks

Gaya teks.

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

Jika Anda menggunakan metode yang mengedit cara teks menyesuaikan dengan bentuk, setelan penyesuaian 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 berada di bagian 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 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 beberapa gaya pada teks.
isSmallCaps()BooleanMenampilkan true jika teks dalam 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 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 font dan ketebalan teks.
setFontSize(fontSize)TextStyleMenetapkan ukuran font teks, dalam titik.
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 diberikan.
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.
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.

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 titik, 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.

Bobot 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, dalam hal ini isBold() 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 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

Menampilkan Link pada teks, atau null jika tidak ada link atau jika link berada di bagian teks atau jika ada beberapa link. Panggil hasLink() untuk menentukan apakah teks tidak memiliki link. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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 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.

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 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 besar 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 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 cocok dengan teks sebelum link. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.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)

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

Bobot 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, dalam hal ini isBold() 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 titik.

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)

Menetapkan 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 hex 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 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

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.

Menetapkan link akan mengubah gaya teks agar digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Hal ini dapat diubah melalui setForegroundColor(hexColor) dan setUnderline(underline).

Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru di TextRange akan diabaikan. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.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.

Menetapkan link akan mengubah gaya teks agar digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Hal ini dapat diubah melalui setForegroundColor(hexColor) dan setUnderline(underline).

Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru di TextRange akan diabaikan. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.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.

Menetapkan link akan mengubah gaya teks agar digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Hal ini dapat diubah melalui setForegroundColor(hexColor) dan setUnderline(underline).

Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru di TextRange akan diabaikan. 

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.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.

Menetapkan link akan mengubah gaya teks agar digarisbawahi dan memiliki warna latar depan ThemeColorType.HYPERLINK. Hal ini dapat diubah melalui setForegroundColor(hexColor) dan setUnderline(underline).

Karena link tidak dapat ditetapkan pada karakter baris baru, karakter baris baru di TextRange akan diabaikan. 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.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.

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