Class TextStyle

Styltekstu

Styl tekstu.

Metody odczytu w tej klasie zwracają wartość null, jeśli odpowiedni zakres TextRange obejmuje wiele fragmentów tekstu, a fragmenty te mają różne wartości dla wywoływanej metody odczytu. Aby tego uniknąć, wysyłaj zapytania o style tekstu za pomocą TextRange zwracanych przez metodę TextRange.getRuns().

Jeśli używasz metod, które zmieniają sposób dopasowania tekstu do kształtu, wszystkie ustawienia autodopasowania zastosowane do stylów tekstu zostaną wyłączone.

Metody

MetodaZwracany typKrótki opis
getBackgroundColor()Color|nullZwraca kolor tła tekstu lub null, jeśli tekst ma wiele stylów.
getBaselineOffset()TextBaselineOffset|nullZwraca pionowe przesunięcie tekstu względem jego normalnej pozycji lub null, jeśli tekst ma wiele stylów.
getFontFamily()String|nullZwraca rodzinę czcionek tekstu lub null, jeśli tekst zawiera wiele stylów.
getFontSize()Number|nullZwraca rozmiar czcionki tekstu w punktach lub null, jeśli tekst ma wiele stylów.
getFontWeight()Integer|nullZwraca grubość czcionki tekstu lub null, jeśli tekst ma wiele stylów.
getForegroundColor()Color|nullZwraca kolor pierwszego planu tekstu lub null, jeśli tekst ma wiele stylów.
getLink()Link|nullZwraca Link w tekście lub null, jeśli nie ma linku, link znajduje się w części tekstu lub jest wiele linków.
hasLink()Boolean|nullZwraca true, jeśli w tekście znajduje się link, false, jeśli nie, lub null, jeśli link znajduje się w części tekstu lub jest wiele linków.
isBackgroundTransparent()Boolean|nullZwraca wartość true, jeśli tło tekstu jest przezroczyste, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
isBold()Boolean|nullZwraca true, jeśli tekst jest renderowany jako pogrubiony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
isItalic()Boolean|nullZwraca true, jeśli tekst jest zapisany kursywą, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
isSmallCaps()Boolean|nullZwraca true, jeśli tekst jest zapisany małymi literami, false, jeśli nie, lub null, jeśli tekst zawiera wiele stylów.
isStrikethrough()Boolean|nullZwraca true, jeśli tekst jest przekreślony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
isUnderline()Boolean|nullZwraca true, jeśli tekst jest podkreślony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
removeLink()TextStyleUsuwa Link.
setBackgroundColor(color)TextStyleUstawia kolor tła tekstu.
setBackgroundColor(red, green, blue)TextStyleUstawia kolor tła tekstu na podane wartości RGB z zakresu od 0 do 255.
setBackgroundColor(hexColor)TextStyleUstawia kolor tła tekstu na podany ciąg znaków w formacie szesnastkowym.
setBackgroundColor(color)TextStyleUstawia kolor tła tekstu na podany kolor ThemeColorType.
setBackgroundColorTransparent()TextStyleUstawia przezroczysty kolor tła tekstu.
setBaselineOffset(offset)TextStyleUstawia przesunięcie pionowe tekstu względem jego normalnego położenia.
setBold(bold)TextStyleOkreśla, czy tekst ma być renderowany jako pogrubiony.
setFontFamily(fontFamily)TextStyleUstawia rodzinę czcionek tekstu .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleUstawia rodzinę i grubość czcionki tekstu.
setFontSize(fontSize)TextStyleUstawia rozmiar czcionki tekstu w punktach.
setForegroundColor(foregroundColor)TextStyleUstawia kolor tekstu.
setForegroundColor(red, green, blue)TextStyleUstawia kolor pierwszego planu tekstu na podane wartości RGB z zakresu od 0 do 255.
setForegroundColor(hexColor)TextStyleUstawia kolor pierwszego planu tekstu na podany ciąg znaków szesnastkowych.
setForegroundColor(color)TextStyleUstawia kolor pierwszego planu tekstu na podany kolor ThemeColorType.
setItalic(italic)TextStyleOkreśla, czy tekst jest pisany kursywą.
setLinkSlide(slideIndex)TextStyleUstawia Link na podany Slide, używając indeksu slajdu liczonego od zera.
setLinkSlide(slide)TextStyleUstawia Link na podany Slide, a link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)TextStyleUstawia Link na podany Slide, używając względnego położenia slajdu.
setLinkUrl(url)TextStyleUstawia Link na podany niepusty ciąg znaków adresu URL.
setSmallCaps(smallCaps)TextStyleOkreśla, czy tekst ma być renderowany małymi wersalikami.
setStrikethrough(strikethrough)TextStyleOkreśla, czy tekst ma być przekreślony.
setUnderline(underline)TextStyleOkreśla, czy tekst ma być podkreślony.

Szczegółowa dokumentacja

getBackgroundColor()

Zwraca kolor tła tekstu lub null, jeśli tekst ma wiele stylów.

Powrót

Color|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getBaselineOffset()

Zwraca pionowe przesunięcie tekstu względem jego normalnej pozycji lub null, jeśli tekst ma wiele stylów.

Powrót

TextBaselineOffset|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontFamily()

Zwraca rodzinę czcionek tekstu lub null, jeśli tekst zawiera wiele stylów.

Powrót

String|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontSize()

Zwraca rozmiar czcionki tekstu w punktach lub null, jeśli tekst ma wiele stylów.

Powrót

Number|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontWeight()

Zwraca grubość czcionki tekstu lub null, jeśli tekst ma wiele stylów.

Waga jest wielokrotnością liczby 100 z zakresu od 100 do 900 (włącznie). Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1, sekcja 15.6, przy czym wartości nieliczbowe są niedozwolone. Wagi równe 700 lub większe są uznawane za pogrubione, w którym to przypadku funkcja isBold() zwraca wartość true. Wartość domyślna to 400 („normal”).

Powrót

Integer|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getForegroundColor()

Zwraca kolor pierwszego planu tekstu lub null, jeśli tekst ma wiele stylów.

Powrót

Color|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Zwraca Link w tekście lub null, jeśli nie ma linku, link znajduje się w części tekstu lub jest wiele linków. Zadzwoń pod numer hasLink(), aby sprawdzić, czy tekst nie zawiera linku. 

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()}`);
}

Powrót

Link|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Zwraca true, jeśli w tekście znajduje się link, false, jeśli nie, lub null, jeśli link znajduje się w części tekstu lub jest wiele linków.

Linków nie można ustawiać na znakach nowego wiersza. Dlatego jeśli TextRange zawiera znak nowego wiersza, ta metoda zawsze zwraca wartość null lub false.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isBackgroundTransparent()

Zwraca wartość true, jeśli tło tekstu jest przezroczyste, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isBold()

Zwraca true, jeśli tekst jest renderowany jako pogrubiony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isItalic()

Zwraca true, jeśli tekst jest zapisany kursywą, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isSmallCaps()

Zwraca true, jeśli tekst jest zapisany małymi literami, false, jeśli nie, lub null, jeśli tekst zawiera wiele stylów.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isStrikethrough()

Zwraca true, jeśli tekst jest przekreślony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isUnderline()

Zwraca true, jeśli tekst jest podkreślony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.

Powrót

Boolean|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Usuwa Link.

Usunięcie linku powoduje usunięcie koloru pierwszego planu hiperlinku i stylu podkreślenia tekstu. Jeśli to możliwe, te style są stosowane w taki sposób, aby pasowały do tekstu poprzedzającego link. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

Powrót

TextStyle

setBackgroundColor(color)

Ustawia kolor tła tekstu.

Parametry

NazwaTypOpis
colorColor

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(red, green, blue)

Ustawia kolor tła tekstu na podane wartości RGB z zakresu od 0 do 255.

Parametry

NazwaTypOpis
redInteger
greenInteger
blueInteger

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(hexColor)

Ustawia kolor tła tekstu na podany ciąg znaków w formacie szesnastkowym.

Ciąg szesnastkowy musi mieć format „#RRGGBB”. Na przykład kolor różowy będzie przedstawiony jako „#FFC0CB”.

Parametry

NazwaTypOpis
hexColorString

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(color)

Ustawia kolor tła tekstu na podany kolor ThemeColorType.

Parametry

NazwaTypOpis
colorThemeColorType

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColorTransparent()

Ustawia przezroczysty kolor tła tekstu.

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBaselineOffset(offset)

Ustawia przesunięcie pionowe tekstu względem jego normalnego położenia.

Parametry

NazwaTypOpis
offsetTextBaselineOffset

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBold(bold)

Określa, czy tekst ma być renderowany jako pogrubiony.

Zmiana pogrubienia tekstu powoduje zaktualizowanie grubości czcionki używanej do renderowania tekstu.

Parametry

NazwaTypOpis
boldBoolean

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontFamily(fontFamily)

Ustawia rodzinę czcionek tekstu .

Parametry

NazwaTypOpis
fontFamilyString

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontFamilyAndWeight(fontFamily, fontWeight)

Ustawia rodzinę i grubość czcionki tekstu.

Waga jest wielokrotnością liczby 100 z zakresu od 100 do 900 (włącznie). Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1, sekcja 15.6, przy czym wartości nieliczbowe są niedozwolone. Wagi równe 700 lub większe są uznawane za pogrubione, w którym to przypadku funkcja isBold() zwraca wartość true. Wartość domyślna to 400 („normal”).

Parametry

NazwaTypOpis
fontFamilyString
fontWeightInteger

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontSize(fontSize)

Ustawia rozmiar czcionki tekstu w punktach.

Parametry

NazwaTypOpis
fontSizeNumber

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(foregroundColor)

Ustawia kolor tekstu.

Parametry

NazwaTypOpis
foregroundColorColor

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(red, green, blue)

Ustawia kolor pierwszego planu tekstu na podane wartości RGB z zakresu od 0 do 255.

Parametry

NazwaTypOpis
redInteger
greenInteger
blueInteger

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(hexColor)

Ustawia kolor pierwszego planu tekstu na podany ciąg znaków szesnastkowych.

Ciąg szesnastkowy musi mieć format „#RRGGBB”. Na przykład kolor różowy będzie przedstawiony jako „#FFC0CB”.

Parametry

NazwaTypOpis
hexColorString

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(color)

Ustawia kolor pierwszego planu tekstu na podany kolor ThemeColorType.

Parametry

NazwaTypOpis
colorThemeColorType

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setItalic(italic)

Określa, czy tekst jest pisany kursywą.

Parametry

NazwaTypOpis
italicBoolean

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Ustawia Link na podany Slide, używając indeksu slajdu liczonego od zera.

Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i z ThemeColorType.HYPERLINK kolorem pierwszego planu. Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać na znakach nowego wiersza, dlatego znaki nowego wiersza w TextRange są ignorowane. 

// 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);

Parametry

NazwaTypOpis
slideIndexIntegerIndeks slajdu liczony od zera.

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slide)

Ustawia Link na podany Slide, a link jest ustawiany przez podany identyfikator slajdu.

Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i z ThemeColorType.HYPERLINK kolorem pierwszego planu. Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać na znakach nowego wiersza, dlatego znaki nowego wiersza w TextRange są ignorowane. 

// 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);

Parametry

NazwaTypOpis
slideSlideSlide do połączenia.

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Ustawia Link na podany Slide, używając względnego położenia slajdu.

Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i z ThemeColorType.HYPERLINK kolorem pierwszego planu. Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać na znakach nowego wiersza, dlatego znaki nowego wiersza w TextRange są ignorowane. 

// 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);

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględna SlidePosition.

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Ustawia Link na podany niepusty ciąg znaków adresu URL.

Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i z ThemeColorType.HYPERLINK kolorem pierwszego planu. Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać na znakach nowego wiersza, dlatego znaki nowego wiersza w TextRange są ignorowane. 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

Parametry

NazwaTypOpis
urlStringCiąg znaków URL.

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setSmallCaps(smallCaps)

Określa, czy tekst ma być renderowany małymi wersalikami.

Parametry

NazwaTypOpis
smallCapsBoolean

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setStrikethrough(strikethrough)

Określa, czy tekst ma być przekreślony.

Parametry

NazwaTypOpis
strikethroughBoolean

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setUnderline(underline)

Określa, czy tekst ma być podkreślony.

Parametry

NazwaTypOpis
underlineBoolean

Powrót

TextStyle

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations