Class TextStyle

TextStyle

Styl tekstu.

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

Jeśli korzystasz z metod edycji dopasowania tekstu do kształtu, wszelkie ustawienia automatycznego dopasowania zastosowane do style tekstu są dezaktywowane.

Metody

MetodaZwracany typKrótki opis
getBackgroundColor()ColorZwraca kolor tła tekstu lub null, jeśli w szablonie tekstu.
getBaselineOffset()TextBaselineOffsetZwraca przesunięcie tekstu w pionie lub wartość null, jeśli podano wiele stylów.
getFontFamily()StringZwraca rodzinę czcionek tekstu lub parametr null, jeśli tekst ma wiele stylów.
getFontSize()NumberZwraca rozmiar czcionki tekstu w punktach lub null, jeśli istnieje wiele stylów tekst.
getFontWeight()IntegerZwraca grubość czcionki tekstu lub null, jeśli tekst ma kilka stylów.
getForegroundColor()ColorZwraca kolor pierwszego planu tekstu lub wartość null, jeśli w elemencie tekstu.
getLink()LinkZwraca Link w tekście lub null, jeśli nie ma linku lub link jest włączony lub jeśli mamy kilka linków.
hasLink()BooleanZwraca true, jeśli tekst zawiera link, false, jeśli nie, lub null, jeśli funkcja występuje w części tekstu lub w wielu linkach.
isBackgroundTransparent()BooleanZwraca true, jeśli tło tekstu jest przezroczyste, false, jeśli nie jest, lub null, jeśli tekst ma kilka stylów.
isBold()BooleanZwraca true, jeśli tekst jest pogrubiony, false, jeśli nie, lub null, jeśli nie jest renderowany. dostępnych jest wiele stylów.
isItalic()BooleanZwraca true, jeśli tekst jest pochylony, false, jeśli nie, lub null, jeśli występuje możesz wybrać różne style.
isSmallCaps()BooleanZwraca true, jeśli tekst został zapisany małymi literami, false, jeśli nie, lub null, jeśli tekst zawiera kilka stylów.
isStrikethrough()BooleanZwraca true, jeśli tekst jest przekreślony, false, jeśli nie, lub null, jeśli tekst jest przekreślony. dostępnych jest wiele stylów.
isUnderline()BooleanZwraca true, jeśli tekst jest podkreślony, false, jeśli nie, lub null, jeśli tekst jest podkreślony możesz wybrać różne style.
removeLink()TextStyleUsuwa element Link.
setBackgroundColor(color)TextStyleUstawia kolor tła tekstu.
setBackgroundColor(red, green, blue)TextStyleUstawia kolor tła tekstu na dane RGB z zakresu od 0 do 255.
setBackgroundColor(hexColor)TextStyleUstawia kolor tła tekstu na podany ciąg szesnastkowy koloru.
setBackgroundColor(color)TextStyleUstawia kolor tła tekstu na podany ThemeColorType.
setBackgroundColorTransparent()TextStyleUstawia przezroczysty kolor tła tekstu.
setBaselineOffset(offset)TextStyleOkreśla przesunię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 dane RGB z zakresu od 0 do 255.
setForegroundColor(hexColor)TextStyleUstawia kolor pierwszego planu tekstu na podany ciąg szesnastkowy koloru.
setForegroundColor(color)TextStyleUstawia kolor pierwszego planu tekstu na podany ThemeColorType.
setItalic(italic)TextStyleOkreśla, czy tekst ma być pisany kursywą.
setLinkSlide(slideIndex)TextStyleUstawia Link na podaną wartość Slide za pomocą indeksu slajdu liczony od zera.
setLinkSlide(slide)TextStyleUstawia element Link na podany element Slide, a link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)TextStyleUstawia Link na podaną wartość Slide na podstawie względnej pozycji slajdu.
setLinkUrl(url)TextStyleUstawia wartość Link na dany ciąg znaków adresu URL, który nie jest pusty.
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 null, jeśli w szablonie tekstu.

Powrót

Color

Autoryzacja

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 przesunięcie tekstu w pionie lub wartość null, jeśli podano wiele stylów.

Powrót

TextBaselineOffset

Autoryzacja

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 parametr null, jeśli tekst ma wiele stylów.

Powrót

String

Autoryzacja

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 wiele stylów tekst.

Powrót

Number

Autoryzacja

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 null, jeśli tekst ma kilka stylów.

Waga jest wielokrotnością wartości 100 z zakresu od 100 do 900 włącznie. Ten zakres odpowiada wartości liczbowe opisane w specyfikacji CSS 2.1 w sekcji 15.6, z wartości inne niż liczbowe są niedozwolone. Waga większa lub równa 700 jest uznawana za pogrubioną. w którym przypadku isBold() zwraca wartość true. Wartość domyślna to 400. („normalne”).

Powrót

Integer

Autoryzacja

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 wartość null, jeśli w elemencie tekstu.

Powrót

Color

Autoryzacja

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 lub link jest włączony lub jeśli mamy kilka linków. Wywołaj hasLink(), aby określić, czy tekst nie zawiera linku. 

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

Powrót

Link

Autoryzacja

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 tekst zawiera link, false, jeśli nie, lub null, jeśli funkcja występuje w części tekstu lub w wielu linkach.

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

Powrót

Boolean

Autoryzacja

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 kilka stylów.

Powrót

Boolean

Autoryzacja

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 pogrubiony, false, jeśli nie, lub null, jeśli nie jest renderowany. dostępnych jest wiele stylów.

Powrót

Boolean

Autoryzacja

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 pochylony, false, jeśli nie, lub null, jeśli występuje możesz wybrać różne style.

Powrót

Boolean

Autoryzacja

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 został zapisany małymi literami, false, jeśli nie, lub null, jeśli tekst zawiera kilka stylów.

Powrót

Boolean

Autoryzacja

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 jest przekreślony. dostępnych jest wiele stylów.

Powrót

Boolean

Autoryzacja

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 jest podkreślony możesz wybrać różne style.

Powrót

Boolean

Autoryzacja

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 element Link.

Usunięcie linku spowoduje usunięcie koloru pierwszego planu hiperlinku i stylu podkreślenia tekstu. Jeśli to style, które zostaną zastosowane tak, aby pasowały do tekstu poprzedzającego link. 

text.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 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 dane 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 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 ciąg szesnastkowy koloru.

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

Parametry

NazwaTypOpis
hexColorString

Powrót

TextStyle

Autoryzacja

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

Parametry

NazwaTypOpis
colorThemeColorType

Powrót

TextStyle

Autoryzacja

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.

Powrót

TextStyle

Autoryzacja

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)

Określa przesunięcie tekstu w pionie względem jego normalnego położenia.

Parametry

NazwaTypOpis
offsetTextBaselineOffset

Powrót

TextStyle

Autoryzacja

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

Parametry

NazwaTypOpis
boldBoolean

Powrót

TextStyle

Autoryzacja

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

Powrót

TextStyle

Autoryzacja

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ą wartości 100 z zakresu od 100 do 900 włącznie. Ten zakres odpowiada wartości liczbowe opisane w specyfikacji CSS 2.1 w sekcji 15.6, z wartości inne niż liczbowe są niedozwolone. Waga większa lub równa 700 jest uznawana za pogrubioną. w którym przypadku isBold() zwraca wartość true. Wartość domyślna to 400. („normalne”).

Parametry

NazwaTypOpis
fontFamilyString
fontWeightInteger

Powrót

TextStyle

Autoryzacja

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

Powrót

TextStyle

Autoryzacja

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

Powrót

TextStyle

Autoryzacja

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 dane 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 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 ciąg szesnastkowy koloru.

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

Parametry

NazwaTypOpis
hexColorString

Powrót

TextStyle

Autoryzacja

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

Parametry

NazwaTypOpis
colorThemeColorType

Powrót

TextStyle

Autoryzacja

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ć pisany kursywą.

Parametry

NazwaTypOpis
italicBoolean

Powrót

TextStyle

Autoryzacja

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 Link na podaną wartość Slide za pomocą indeksu slajdu liczony od zera.

Ustawienie linku zmienia styl tekstu tak, aby był podkreślony i ustaw kolor pierwszego planu (ThemeColorType.HYPERLINK). Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Ponieważ linków nie można umieszczać w znakach nowego wiersza, znaki nowego wiersza w polu 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.

Powrót

TextStyle

Autoryzacja

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 element Link na podany element Slide, a link jest ustawiany przez podany identyfikator slajdu.

Ustawienie linku zmienia styl tekstu tak, aby był podkreślony i ustaw kolor pierwszego planu (ThemeColorType.HYPERLINK). Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Ponieważ linków nie można umieszczać w znakach nowego wiersza, znaki nowego wiersza w polu 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.

Powrót

TextStyle

Autoryzacja

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 Link na podaną wartość Slide na podstawie względnej pozycji slajdu.

Ustawienie linku zmienia styl tekstu tak, aby był podkreślony i ustaw kolor pierwszego planu (ThemeColorType.HYPERLINK). Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Ponieważ linków nie można umieszczać w znakach nowego wiersza, znaki nowego wiersza w polu TextRange są ignorowane. 

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

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględna wartość SlidePosition.

Powrót

TextStyle

Autoryzacja

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 wartość Link na dany ciąg znaków adresu URL, który nie jest pusty.

Ustawienie linku zmienia styl tekstu tak, aby był podkreślony i ustaw kolor pierwszego planu (ThemeColorType.HYPERLINK). Możesz to zmienić w setForegroundColor(hexColor) i setUnderline(underline).

Ponieważ linków nie można umieszczać w znakach nowego wiersza, znaki nowego wiersza w polu TextRange są ignorowane. 

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

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Powrót

TextStyle

Autoryzacja

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

Powrót

TextStyle

Autoryzacja

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

Powrót

TextStyle

Autoryzacja

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

Powrót

TextStyle

Autoryzacja

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