Class TextStyle

GayaTeks

Gaya teks.

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

Jika Anda menggunakan metode yang mengedit cara teks menyesuaikan bentuk, semua setelan pengepasan otomatis yang diterapkan ke gaya teks akan dinonaktifkan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getBackgroundColor()Color|nullMenampilkan warna latar belakang teks, atau null jika ada beberapa gaya pada teks.
getBaselineOffset()TextBaselineOffset|nullMenampilkan offset vertikal teks dari posisi normalnya, atau null jika ada beberapa gaya pada teks.
getFontFamily()String|nullMenampilkan jenis font teks, atau null jika ada beberapa gaya pada teks.
getFontSize()Number|nullMenampilkan ukuran font teks dalam satuan poin, atau null jika ada beberapa gaya pada teks.
getFontWeight()Integer|nullMenampilkan ketebalan font teks, atau null jika ada beberapa gaya pada teks.
getForegroundColor()Color|nullMenampilkan warna latar depan teks, atau null jika ada beberapa gaya pada teks.
getLink()Link|nullMenampilkan Link pada teks, atau null jika tidak ada link atau jika link ada di sebagian teks atau jika ada beberapa link.
hasLink()Boolean|nullMenampilkan true jika ada link pada teks, false jika tidak ada, atau null jika link ada pada sebagian teks atau ada beberapa link.
isBackgroundTransparent()Boolean|nullMenampilkan true jika latar belakang teks transparan, false jika tidak, atau null jika ada beberapa gaya pada teks.
isBold()Boolean|nullMenampilkan true jika teks dirender sebagai tebal, false jika tidak, atau null jika ada beberapa gaya pada teks.
isItalic()Boolean|nullMenampilkan true jika teks dimiringkan, false jika tidak, atau null jika ada beberapa gaya pada teks.
isSmallCaps()Boolean|nullMenampilkan true jika teks dalam huruf kapital kecil, false jika tidak, atau null jika ada beberapa gaya pada teks.
isStrikethrough()Boolean|nullMenampilkan true jika teks dicoret, false jika tidak, atau null jika ada beberapa gaya pada teks.
isUnderline()Boolean|nullMenampilkan 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 hex 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 satuan 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 hex yang diberikan.
setForegroundColor(color)TextStyleMenetapkan warna latar depan teks ke ThemeColorType yang diberikan.
setItalic(italic)TextStyleMenetapkan apakah teks dimiringkan.
setLinkSlide(slideIndex)TextStyleMenetapkan Link ke Slide tertentu menggunakan indeks berbasis nol slide.
setLinkSlide(slide)TextStyleMenetapkan Link ke Slide tertentu, link ditetapkan oleh ID slide tertentu.
setLinkSlide(slidePosition)TextStyleMenetapkan Link ke Slide tertentu menggunakan posisi relatif slide.
setLinkUrl(url)TextStyleMenetapkan Link ke string URL yang tidak kosong yang diberikan.
setSmallCaps(smallCaps)TextStyleMenetapkan apakah teks dirender dalam huruf kapital 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|null

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|null

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|null

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 satuan poin, atau null jika ada beberapa gaya pada teks.

Pulang pergi

Number|null

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. Ketebalan yang lebih besar dari atau sama dengan 700 dianggap tebal, sehingga isBold() menampilkan true. Nilai defaultnya adalah 400 ("normal").

Pulang pergi

Integer|null

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|null

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. 

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|null

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 ada, atau null jika link ada pada sebagian teks atau ada beberapa link.

Link tidak dapat disetel pada karakter baris baru. Oleh karena itu, jika TextRange berisi karakter baris baru, metode ini akan selalu menampilkan null atau false.

Pulang pergi

Boolean|null

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|null

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|null

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 dimiringkan, false jika tidak, atau null jika ada beberapa gaya pada teks.

Pulang pergi

Boolean|null

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|null

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|null

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|null

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

String hex harus dalam format '#RRGGBB'. Misalnya, warna merah muda akan ditampilkan 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.

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. Ketebalan yang lebih besar dari atau sama dengan 700 dianggap tebal, sehingga 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 satuan 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)

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

String hex harus dalam format '#RRGGBB'. Misalnya, warna merah muda akan ditampilkan 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 dimiringkan.

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

Menetapkan link akan mengubah gaya teks menjadi bergaris bawah 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 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 tertentu, link ditetapkan oleh ID slide tertentu.

Menetapkan link akan mengubah gaya teks menjadi bergaris bawah 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 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 tertentu menggunakan posisi relatif slide.

Menetapkan link akan mengubah gaya teks menjadi bergaris bawah 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 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 yang diberikan.

Menetapkan link akan mengubah gaya teks menjadi bergaris bawah 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 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 kapital 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