Styl tekstu.
Metody odczytu w tej klasie zwracają null
, jeśli odpowiadający im element Text
obejmuje wiele fragmentów tekstu, a te fragmenty mają różne wartości wywoływanej metody odczytu. Aby tego uniknąć, przeprowadź zapytanie o style tekstu, używając Text
zwróconych przez metodę Text
.
Jeśli używasz metod, które zmieniają sposób dopasowywania tekstu do kształtu, wszystkie ustawienia autodopasowania zastosowane do stylów tekstu są dezaktywowane.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
get | Color | Zwraca kolor tła tekstu lub null , jeśli tekst ma wiele stylów. |
get | Text | Zwraca przesunięcie pionowe tekstu od jego normalnej pozycji lub null , jeśli tekst ma wiele stylów. |
get | String | Zwraca rodzinę czcionek tekstu lub null , jeśli tekst ma wiele stylów. |
get | Number | Zwraca rozmiar czcionki tekstu w punktach lub null , jeśli tekst ma wiele stylów. |
get | Integer | Zwraca grubość czcionki tekstu lub null , jeśli tekst ma wiele stylów. |
get | Color | Zwraca kolor pierwszego planu tekstu lub null , jeśli tekst ma wiele stylów. |
get | Link | Zwraca Link w tekście lub null , jeśli nie ma linku lub jeśli link jest częścią tekstu lub jeśli jest ich kilka. |
has | Boolean | Zwraca wartość true , jeśli w tekście jest link, false , jeśli go nie ma, lub null , jeśli link jest częścią tekstu lub jeśli jest ich kilka. |
is | Boolean | Zwraca wartość true , jeśli tło tekstu jest przezroczyste, false , jeśli nie jest przezroczyste, lub null , jeśli tekst ma wiele stylów. |
is | Boolean | Zwraca wartość true , jeśli tekst jest wyświetlany pogrubioną czcionką, wartość false , jeśli nie jest, lub wartość null , jeśli tekst ma wiele stylów. |
is | Boolean | Zwraca wartość true , jeśli tekst jest pochylony, false , jeśli nie jest pochylony, lub null , jeśli tekst ma wiele stylów. |
is | Boolean | Zwraca wartość true , jeśli tekst jest w małej literze, false , jeśli nie jest, lub null , jeśli tekst ma wiele stylów. |
is | Boolean | Zwraca wartość true , jeśli tekst jest przekreślony, false , jeśli nie jest przekreślony, lub null , jeśli tekst ma wiele stylów. |
is | Boolean | Zwraca wartość true , jeśli tekst jest podkreślony, false , jeśli nie jest podkreślony, lub null , jeśli tekst ma wiele stylów. |
remove | Text | Usuwa Link . |
set | Text | Ustawia kolor tła tekstu. |
set | Text | Ustawia kolor tła tekstu na podane wartości RGB od 0 do 255. |
set | Text | Ustawia kolor tła tekstu na podany ciąg znaków koloru heksadecymalnego. |
set | Text | Ustawia kolor tła tekstu na określony Theme . |
set | Text | Ustawia przezroczysty kolor tła tekstu. |
set | Text | Ustawia przesunięcie pionowe tekstu względem jego normalnej pozycji. |
set | Text | Określa, czy tekst ma być wyświetlany pogrubioną czcionką. |
set | Text | Ustawia rodzinę czcionek tekstu . |
set | Text | Ustawia rodzinę czcionek i grubość tekstu. |
set | Text | Ustawia rozmiar czcionki tekstu w punktach. |
set | Text | Ustawia kolor pierwszego planu tekstu. |
set | Text | Ustawia kolor pierwszego planu tekstu na podane wartości RGB od 0 do 255. |
set | Text | Ustawia kolor pierwszego planu tekstu na podany ciąg znaków koloru heksadecymalnego. |
set | Text | Ustawia kolor pierwszego planu tekstu na określony Theme . |
set | Text | Określa, czy tekst ma być kursywą. |
set | Text | Przypisuje wartość Link do podanego parametru Slide , używając indeksu liczonego od 0. |
set | Text | Ustawia Link na podanym Slide , a link jest ustawiany za pomocą podanego identyfikatora slajdu. |
set | Text | Ustawia Link na podanej wartości Slide , używając względnego położenia slajdu. |
set | Text | Ustawia Link na podany niepusty ciąg znaków adresu URL. |
set | Text | Określa, czy tekst jest renderowany w małych literach. |
set | Text | Określa, czy tekst ma być przekreślony. |
set | Text | Określa, czy tekst ma być podkreślony. |
Szczegółowa dokumentacja
get Background Color()
get Baseline Offset()
Zwraca przesunięcie pionowe tekstu od jego normalnej pozycji lub null
, jeśli tekst ma wiele stylów.
Powrót
Autoryzacja
Skrypty, które korzystają 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
get Font Family()
Zwraca rodzinę czcionek tekstu lub null
, jeśli tekst ma wiele stylów.
Powrót
String
Autoryzacja
Skrypty, które korzystają 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
get Font Size()
Zwraca rozmiar czcionki tekstu w punktach lub null
, jeśli tekst ma wiele stylów.
Powrót
Number
Autoryzacja
Skrypty, które korzystają 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
get Font Weight()
Zwraca grubość czcionki tekstu lub null
, jeśli tekst ma wiele stylów.
Waga jest wielokrotnością 100 z zakresu od 100 do 900 włącznie. Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1 (sekcja 15.6), z tym że wartości niebędące liczbami są niedozwolone. Wagi większe lub równe 700 są uważane za pogrubione, w którym przypadku is
zwraca true
. Wartość domyślna to 400 („normalny”).
Powrót
Integer
Autoryzacja
Skrypty, które korzystają 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
get Foreground Color()
Zwraca kolor pierwszego planu tekstu lub null
, jeśli tekst ma wiele stylów.
Powrót
Autoryzacja
Skrypty, które korzystają 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
get Link()
Zwraca Link
w tekście lub null
, jeśli nie ma linku lub jeśli link jest częścią tekstu lub jeśli jest ich kilka. Zadzwoń pod numer has
, aby sprawdzić, czy SMS 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
Autoryzacja
Skrypty, które korzystają 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
has Link()
Zwraca wartość true
, jeśli w tekście jest link, false
, jeśli go nie ma, lub null
, jeśli link jest częścią tekstu lub jeśli jest ich kilka.
Nie można ustawiać linków na znakach nowego wiersza. Dlatego jeśli Text
zawiera znak tabulacji, ta metoda zawsze zwraca null
lub false
.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
is Background Transparent()
Zwraca wartość true
, jeśli tło tekstu jest przezroczyste, false
, jeśli nie jest przezroczyste, lub null
, jeśli tekst ma wiele stylów.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
is Bold()
Zwraca wartość true
, jeśli tekst jest wyświetlany pogrubioną czcionką, wartość false
, jeśli nie jest, lub wartość null
, jeśli tekst ma wiele stylów.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
is Italic()
Zwraca wartość true
, jeśli tekst jest pochylony, false
, jeśli nie jest pochylony, lub null
, jeśli tekst ma wiele stylów.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
is Small Caps()
Zwraca wartość true
, jeśli tekst jest w małej literze, false
, jeśli nie jest, lub null
, jeśli tekst ma wiele stylów.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
is Strikethrough()
Zwraca wartość true
, jeśli tekst jest przekreślony, false
, jeśli nie jest przekreślony, lub null
, jeśli tekst ma wiele stylów.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
is Underline()
Zwraca wartość true
, jeśli tekst jest podkreślony, false
, jeśli nie jest podkreślony, lub null
, jeśli tekst ma wiele stylów.
Powrót
Boolean
Autoryzacja
Skrypty, które korzystają 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
remove Link()
Usuwa Link
.
Usunięcie linku powoduje usunięcie koloru tła hiperlinku i stylu podkreślenia tekstu. Jeśli to możliwe, te style są stosowane w celu dopasowania tekstu poprzedzającego link.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().removeLink();
Powrót
set Background Color(color)
set Background Color(red, green, blue)
Ustawia kolor tła tekstu na podane wartości RGB od 0 do 255.
Parametry
Nazwa | Typ | Opis |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Background Color(hexColor)
Ustawia kolor tła tekstu na podany ciąg znaków koloru heksadecymalnego.
Ciąg szesnastkowy musi mieć format „#RRGGBB”. Na przykład różowy będzie reprezentowany jako „#FFC0CB”.
Parametry
Nazwa | Typ | Opis |
---|---|---|
hex | String |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Background Color(color)
Ustawia kolor tła tekstu na określony Theme
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Theme |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Background ColorTransparent()
set Baseline Offset(offset)
Ustawia przesunięcie pionowe tekstu względem jego normalnej pozycji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Text |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Bold(bold)
Określa, czy tekst ma być wyświetlany pogrubioną czcionką.
Zmiana pogrubienia tekstu aktualizuje grubość czcionki używanej do renderowania tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
bold | Boolean |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Font Family(fontFamily)
Ustawia rodzinę czcionek tekstu .
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | String |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Font FamilyAndWeight(fontFamily, fontWeight)
Ustawia rodzinę czcionek i grubość tekstu.
Waga jest wielokrotnością 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 niebędące liczbami są niedozwolone. Wagi większe lub równe 700 są uważane za pogrubione, w którym przypadku is
zwraca true
. Wartość domyślna to 400 („normalny”).
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | String | |
font | Integer |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Font Size(fontSize)
Ustawia rozmiar czcionki tekstu w punktach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
font | Number |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Foreground Color(foregroundColor)
Ustawia kolor pierwszego planu tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
foreground | Color |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Foreground Color(red, green, blue)
Ustawia kolor pierwszego planu tekstu na podane wartości RGB od 0 do 255.
Parametry
Nazwa | Typ | Opis |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Foreground Color(hexColor)
Ustawia kolor pierwszego planu tekstu na podany ciąg znaków koloru heksadecymalnego.
Ciąg szesnastkowy musi mieć format „#RRGGBB”. Na przykład różowy będzie reprezentowany jako „#FFC0CB”.
Parametry
Nazwa | Typ | Opis |
---|---|---|
hex | String |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Foreground Color(color)
Ustawia kolor pierwszego planu tekstu na określony Theme
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Theme |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Italic(italic)
Określa, czy tekst ma być kursywą.
Parametry
Nazwa | Typ | Opis |
---|---|---|
italic | Boolean |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Link Slide(slideIndex)
Przypisuje wartość Link
do podanego parametru Slide
, używając indeksu liczonego od 0.
Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i nadanie mu koloru Theme
na pierwszym planie. Możesz to zmienić za pomocą parametrów set
i set
.
Ponieważ nie można ustawiać linków na znakach nowego wiersza, znaki nowego wiersza w sekcji Text
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
Nazwa | Typ | Opis |
---|---|---|
slide | Integer | Indeks slajdów liczony od zera. |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Link Slide(slide)
Ustawia Link
na podanym Slide
, a link jest ustawiany za pomocą podanego identyfikatora slajdu.
Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i nadanie mu koloru Theme
na pierwszym planie. Możesz to zmienić za pomocą parametrów set
i set
.
Ponieważ linków nie można ustawiać na znakach nowego wiersza, znaki nowego wiersza w sekcji Text
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
Nazwa | Typ | Opis |
---|---|---|
slide | Slide | Slide , które mają być połączone. |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Link Slide(slidePosition)
Ustawia Link
na podanej wartości Slide
, używając względnego położenia slajdu.
Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i nadanie mu koloru Theme
na pierwszym planie. Możesz to zmienić za pomocą parametrów set
i set
.
Ponieważ nie można ustawiać linków na znakach nowego wiersza, znaki nowego wiersza w sekcji Text
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
Nazwa | Typ | Opis |
---|---|---|
slide | Slide | Względne Slide . |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Link Url(url)
Ustawia Link
na podany niepusty ciąg znaków adresu URL.
Ustawienie linku powoduje zmianę stylu tekstu na podkreślony i nadanie mu koloru Theme
na pierwszym planie. Możesz to zmienić za pomocą parametrów set
i set
.
Ponieważ nie można ustawiać linków na znakach nowego wiersza, znaki nowego wiersza w sekcji Text
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
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL. |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Small Caps(smallCaps)
Określa, czy tekst jest renderowany w małych literach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
small | Boolean |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Strikethrough(strikethrough)
Określa, czy tekst ma być przekreślony.
Parametry
Nazwa | Typ | Opis |
---|---|---|
strikethrough | Boolean |
Powrót
Autoryzacja
Skrypty, które korzystają 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
set Underline(underline)
Określa, czy tekst ma być podkreślony.
Parametry
Nazwa | Typ | Opis |
---|---|---|
underline | Boolean |
Powrót
Autoryzacja
Skrypty, które korzystają 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