Class TextStyle

TextStyle

Styl tekstu.

Metody odczytu w tej klasie zwracają wartość null, jeśli odpowiednie TextRange obejmuje wiele uruchomień tekstu, które mają różne wartości dla wywoływanej metody. Aby tego uniknąć, utwórz zapytanie o style tekstu, używając elementów TextRange zwracanych przez metodę TextRange.getRuns().

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

Metody

MetodaZwracany typKrótki opis
getBackgroundColor()ColorZwraca kolor tła tekstu lub wartość null, jeśli tekst istnieje wiele stylów.
getBaselineOffset()TextBaselineOffsetZwraca odsunięcie tekstu w pionie od jego normalnego położenia lub o null, jeśli tekst ma wiele stylów.
getFontFamily()StringZwraca rodzinę czcionek tekstu lub null, jeśli występuje kilka stylów tekstu.
getFontSize()NumberZwraca rozmiar czcionki tekstu w punktach lub null, jeśli istnieje kilka stylów tekstu.
getFontWeight()IntegerZwraca grubość czcionki tekstu lub wartość null, jeśli występuje kilka stylów.
getForegroundColor()ColorZwraca kolor pierwszego planu tekstu lub null, jeśli istnieje kilka stylów.
getLink()LinkZwraca Link w tekście lub null, jeśli nie ma linku, link znajduje się w części tekstu lub jeśli istnieje wiele linków.
hasLink()BooleanZwraca 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 gdy istnieje wiele linków.
isBackgroundTransparent()BooleanZwraca true, jeśli tło tekstu jest przezroczyste, false, jeśli nie jest, lub null, jeśli tekst ma wiele stylów.
isBold()BooleanZwraca true, jeśli tekst jest renderowany jako pogrubienie, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
isItalic()BooleanZwraca true, jeśli tekst jest pisany kursywą, false, jeśli nie, lub null, jeśli tekst ma kilka stylów.
isSmallCaps()BooleanZwraca true, jeśli tekst jest pisany małymi literami, false, jeśli nie, lub null, jeśli występuje wiele stylów.
isStrikethrough()BooleanZwraca true, jeśli tekst jest przekreślony, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.
isUnderline()BooleanZwraca 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 szesnastkowy kod koloru.
setBackgroundColor(color)TextStyleUstawia kolor tła tekstu na podany element ThemeColorType.
setBackgroundColorTransparent()TextStyleUstawia przezroczysty kolor tła tekstu.
setBaselineOffset(offset)TextStyleUstawia odsunięcie tekstu w pionie względem jego normalnego położenia.
setBold(bold)TextStyleOkreśla, czy tekst ma być pogrubiony.
setFontFamily(fontFamily)TextStyleUstawia rodzinę czcionek tekstu .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleUstawia rodzinę czcionek i grubość tekstu.
setFontSize(fontSize)TextStyleUstawia rozmiar czcionki tekstu w punktach.
setForegroundColor(foregroundColor)TextStyleUstawia kolor pierwszego planu 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 szesnastkowy kod koloru.
setForegroundColor(color)TextStyleUstawia kolor pierwszego planu tekstu na podany element ThemeColorType.
setItalic(italic)TextStyleOkreśla, czy tekst ma być pochylony.
setLinkSlide(slideIndex)TextStyleUstawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera.
setLinkSlide(slide)TextStyleUstawia w polu Link wartość Slide. Link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)TextStyleUstawia element Link na Slide przy użyciu względnego położenia slajdu.
setLinkUrl(url)TextStyleUstawia Link na podany niepusty ciąg adresu URL.
setSmallCaps(smallCaps)TextStyleOkreśla, czy tekst ma być renderowany małymi literami.
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 wartość null, jeśli tekst istnieje wiele stylów.

Powroty

Color

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getBaselineOffset()

Zwraca odsunięcie tekstu w pionie od jego normalnego położenia lub o null, jeśli tekst ma wiele stylów.

Powroty

TextBaselineOffset

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 występuje kilka stylów tekstu.

Powroty

String

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 istnieje kilka stylów tekstu.

Powroty

Number

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getFontWeight()

Zwraca grubość czcionki tekstu lub wartość null, jeśli występuje kilka stylów.

Waga jest wielokrotnością liczby 100 z przedziału od 100 do 900 włącznie. Zakres ten odpowiada wartościom liczbowym opisanym w sekcji 15.6 specyfikacji CSS 2.1, przy czym wartości nieliczbowe są zabronione. Waga większa lub równa 700 jest uznawana za pogrubienie. W takim przypadku isBold() zwraca wartość true. Wartość domyślna to 400 („normalny”).

Powroty

Integer

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 istnieje kilka stylów.

Powroty

Color

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 jeśli istnieje wiele linków. Wywołaj hasLink(), aby sprawdzić, czy tekst nie ma linku. 

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

Powroty

Link

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 gdy istnieje wiele linków.

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

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

isBackgroundTransparent()

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

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 pogrubienie, false, jeśli nie, lub null, jeśli tekst ma wiele stylów.

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

isItalic()

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

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

isSmallCaps()

Zwraca true, jeśli tekst jest pisany małymi literami, false, jeśli nie, lub null, jeśli występuje wiele stylów.

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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.

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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.

Powroty

Boolean

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 w tekście. Jeśli to możliwe, style te są stosowane w celu dopasowania tekstu poprzedzającego link. 

text.getTextStyle().removeLink();

Powroty

TextStyle

setBackgroundColor(color)

Ustawia kolor tła tekstu.

Parametry

NazwaTypOpis
colorColor

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 szesnastkowy kod koloru.

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

Parametry

NazwaTypOpis
hexColorString

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 element ThemeColorType.

Parametry

NazwaTypOpis
colorThemeColorType

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setBackgroundColorTransparent()

Ustawia przezroczysty kolor tła tekstu.

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setBaselineOffset(offset)

Ustawia odsunięcie tekstu w pionie względem jego normalnego położenia.

Parametry

NazwaTypOpis
offsetTextBaselineOffset

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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ć pogrubiony.

Zmiana pogrubienia tekstu powoduje zaktualizowanie grubości czcionki użytej do wyrenderowania tekstu.

Parametry

NazwaTypOpis
boldBoolean

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setFontFamilyAndWeight(fontFamily, fontWeight)

Ustawia rodzinę czcionek i grubość tekstu.

Waga jest wielokrotnością liczby 100 z przedziału od 100 do 900 włącznie. Zakres ten odpowiada wartościom liczbowym opisanym w sekcji 15.6 specyfikacji CSS 2.1, przy czym wartości nieliczbowe są zabronione. Waga większa lub równa 700 jest uznawana za pogrubienie. W takim przypadku isBold() zwraca wartość true. Wartość domyślna to 400 („normalny”).

Parametry

NazwaTypOpis
fontFamilyString
fontWeightInteger

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setForegroundColor(foregroundColor)

Ustawia kolor pierwszego planu tekstu.

Parametry

NazwaTypOpis
foregroundColorColor

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 szesnastkowy kod koloru.

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

Parametry

NazwaTypOpis
hexColorString

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 element ThemeColorType.

Parametry

NazwaTypOpis
colorThemeColorType

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setItalic(italic)

Określa, czy tekst ma być pochylony.

Parametry

NazwaTypOpis
italicBoolean

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkSlide(slideIndex)

Ustawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera.

Ustawienie linku powoduje, że styl tekstu jest podkreślany i ma kolor pierwszego planu ThemeColorType.HYPERLINK. Możesz to zmienić w usługach setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać w nowym wierszu, więc znaki nowego wiersza w TextRange są ignorowane. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(0);

Parametry

NazwaTypOpis
slideIndexIntegerIndeks liczony od zera dla slajdu.

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkSlide(slide)

Ustawia w polu Link wartość Slide. Link jest ustawiany przez podany identyfikator slajdu.

Ustawienie linku powoduje, że styl tekstu jest podkreślany i ma kolor pierwszego planu ThemeColorType.HYPERLINK. Możesz to zmienić w usługach setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać w nowym wierszu, więc znaki nowego wiersza w TextRange są ignorowane. 

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
text.getTextStyle().setLinkSlide(slide);

Parametry

NazwaTypOpis
slideSlideSlide do połączenia.

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkSlide(slidePosition)

Ustawia element Link na Slide przy użyciu względnego położenia slajdu.

Ustawienie linku powoduje, że styl tekstu jest podkreślany i ma kolor pierwszego planu ThemeColorType.HYPERLINK. Możesz to zmienić w usługach setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać w nowym wierszu, więc znaki nowego wiersza w TextRange są ignorowane. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględny SlidePosition.

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 adresu URL.

Ustawienie linku powoduje, że styl tekstu jest podkreślany i ma kolor pierwszego planu ThemeColorType.HYPERLINK. Możesz to zmienić w usługach setForegroundColor(hexColor) i setUnderline(underline).

Linków nie można ustawiać w nowym wierszu, więc znaki nowego wiersza w TextRange są ignorowane. 

// Set a link to the URL.
text.getTextStyle().setLinkUrl("https://slides.google.com");

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 literami.

Parametry

NazwaTypOpis
smallCapsBoolean

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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

Powroty

TextStyle

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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