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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getBackgroundColor() | Color | Zwraca kolor tła tekstu lub wartość null , jeśli tekst istnieje wiele stylów. |
getBaselineOffset() | TextBaselineOffset | Zwraca odsunięcie tekstu w pionie od jego normalnego położenia lub o null , jeśli tekst ma wiele stylów. |
getFontFamily() | String | Zwraca rodzinę czcionek tekstu lub null , jeśli występuje kilka stylów tekstu. |
getFontSize() | Number | Zwraca rozmiar czcionki tekstu w punktach lub null , jeśli istnieje kilka stylów tekstu. |
getFontWeight() | Integer | Zwraca grubość czcionki tekstu lub wartość null , jeśli występuje kilka stylów. |
getForegroundColor() | Color | Zwraca kolor pierwszego planu tekstu lub null , jeśli istnieje kilka stylów. |
getLink() | Link | 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. |
hasLink() | Boolean | 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. |
isBackgroundTransparent() | Boolean | Zwraca true , jeśli tło tekstu jest przezroczyste, false , jeśli nie jest, lub null , jeśli tekst ma wiele stylów. |
isBold() | Boolean | Zwraca true , jeśli tekst jest renderowany jako pogrubienie, false , jeśli nie, lub null , jeśli tekst ma wiele stylów. |
isItalic() | Boolean | Zwraca true , jeśli tekst jest pisany kursywą, false , jeśli nie, lub null , jeśli tekst ma kilka stylów. |
isSmallCaps() | Boolean | Zwraca true , jeśli tekst jest pisany małymi literami, false , jeśli nie, lub null , jeśli występuje wiele stylów. |
isStrikethrough() | Boolean | Zwraca true , jeśli tekst jest przekreślony, false , jeśli nie, lub null , jeśli tekst ma wiele stylów. |
isUnderline() | Boolean | Zwraca true , jeśli tekst jest podkreślony, false , jeśli nie, lub null , jeśli tekst ma wiele stylów. |
removeLink() | TextStyle | Usuwa: Link . |
setBackgroundColor(color) | TextStyle | Ustawia kolor tła tekstu. |
setBackgroundColor(red, green, blue) | TextStyle | Ustawia kolor tła tekstu na podane wartości RGB z zakresu od 0 do 255. |
setBackgroundColor(hexColor) | TextStyle | Ustawia kolor tła tekstu na podany szesnastkowy kod koloru. |
setBackgroundColor(color) | TextStyle | Ustawia kolor tła tekstu na podany element ThemeColorType . |
setBackgroundColorTransparent() | TextStyle | Ustawia przezroczysty kolor tła tekstu. |
setBaselineOffset(offset) | TextStyle | Ustawia odsunięcie tekstu w pionie względem jego normalnego położenia. |
setBold(bold) | TextStyle | Określa, czy tekst ma być pogrubiony. |
setFontFamily(fontFamily) | TextStyle | Ustawia rodzinę czcionek tekstu . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Ustawia rodzinę czcionek i grubość tekstu. |
setFontSize(fontSize) | TextStyle | Ustawia rozmiar czcionki tekstu w punktach. |
setForegroundColor(foregroundColor) | TextStyle | Ustawia kolor pierwszego planu tekstu. |
setForegroundColor(red, green, blue) | TextStyle | Ustawia kolor pierwszego planu tekstu na podane wartości RGB z zakresu od 0 do 255. |
setForegroundColor(hexColor) | TextStyle | Ustawia kolor pierwszego planu tekstu na podany szesnastkowy kod koloru. |
setForegroundColor(color) | TextStyle | Ustawia kolor pierwszego planu tekstu na podany element ThemeColorType . |
setItalic(italic) | TextStyle | Określa, czy tekst ma być pochylony. |
setLinkSlide(slideIndex) | TextStyle | Ustawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera. |
setLinkSlide(slide) | TextStyle | Ustawia w polu Link wartość Slide . Link jest ustawiany przez podany identyfikator slajdu. |
setLinkSlide(slidePosition) | TextStyle | Ustawia element Link na Slide przy użyciu względnego położenia slajdu. |
setLinkUrl(url) | TextStyle | Ustawia Link na podany niepusty ciąg adresu URL. |
setSmallCaps(smallCaps) | TextStyle | Określa, czy tekst ma być renderowany małymi literami. |
setStrikethrough(strikethrough) | TextStyle | Określa, czy tekst ma być przekreślony. |
setUnderline(underline) | TextStyle | Okreś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
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
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()
getLink()
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
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
hasLink()
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
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
Ustawia kolor tła tekstu na podane wartości RGB z zakresu od 0 do 255.
Parametry
Nazwa | Typ | Opis |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
hexColor | String |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
color | ThemeColorType |
Powroty
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()
setBaselineOffset(offset)
Ustawia odsunięcie tekstu w pionie względem jego normalnego położenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | TextBaselineOffset |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
bold | Boolean |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
fontFamily | String |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
fontSize | Number |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
foregroundColor | Color |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
hexColor | String |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
color | ThemeColorType |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
italic | Boolean |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
slideIndex | Integer | Indeks liczony od zera dla slajdu. |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
slide | Slide | Slide do połączenia. |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
slidePosition | SlidePosition | Względny SlidePosition . |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
url | String | Ciąg adresu URL. |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
smallCaps | Boolean |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
strikethrough | Boolean |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
underline | Boolean |
Powroty
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