Fragment zawartości tekstowej obiektu Shape
lub TableCell
.
Jeśli korzystasz z metod edycji sposobu dopasowania tekstu do kształtu, wszelkie ustawienia automatycznego dopasowania zostaną zastosowane do kształt zostaje wyłączony.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
appendParagraph(text) | Paragraph | Dodaje akapit na końcu zakresu tekstowego. |
appendRange(textRange) | TextRange | Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstowego. |
appendRange(textRange, matchSourceFormatting) | TextRange | Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstowego. |
appendText(text) | TextRange | Dołącza tekst na końcu zakresu tekstu. |
asRenderedString() | String | Zwraca wyrenderowany tekst ograniczony tym zakresem powiązanego kształtu lub komórki tabeli w do wyświetlania użytkownikom. |
asString() | String | Zwraca nieprzetworzony tekst ograniczony do tego zakresu powiązanego kształtu lub komórki tabeli. |
clear() | void | Usuwa tekst ograniczony tym zakresem. |
clear(startOffset, endOffset) | void | Usuwa tekst ograniczony przesunięciem początku i końca zakresu. |
find(pattern) | TextRange[] | Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym. |
find(pattern, startOffset) | TextRange[] | Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym, począwszy od przesunięcie punktu początkowego. |
getAutoTexts() | AutoText[] | Zwraca teksty automatyczne z bieżącego zakresu tekstu. |
getEndIndex() | Integer | Zwraca indeks wyłączny, oparty na 0 dla ostatniego znaku w tym zakresie. |
getLength() | Integer | Zwraca liczbę znaków w danym zakresie. |
getLinks() | TextRange[] | Zwraca zbiór zakresów tekstu, które odpowiadają wszystkim elementom Link w bieżącej
lub na bieżący zakres. |
getListParagraphs() | Paragraph[] | Zwraca na listach akapity, które pokrywają się z bieżącym zakresem tekstowym. |
getListStyle() | ListStyle | Zwraca wartość ListStyle bieżącego zakresu tekstowego. |
getParagraphStyle() | ParagraphStyle | Zwraca wartość ParagraphStyle bieżącego zakresu tekstowego. |
getParagraphs() | Paragraph[] | Zwraca akapity, które nakładają się na bieżący zakres tekstu. |
getRange(startOffset, endOffset) | TextRange | Zwraca nową funkcję TextRange obejmującą część zakresu, z którego pochodzi. |
getRuns() | TextRange[] | Zwraca fragmenty tekstu, które nakładają się na bieżący zakres tekstu. |
getStartIndex() | Integer | Zwraca indeks zaczynający się od 0 dla pierwszego znaku w tym zakresie. |
getTextStyle() | TextStyle | Zwraca styl tekstu zakresu lub null , jeśli zakres jest pusty. |
insertParagraph(startOffset, text) | Paragraph | Wstawia akapit od miejsca początkowego. |
insertRange(startOffset, textRange) | TextRange | Wstawia kopię podanego zakresu tekstu od przesunięcia początkowego. |
insertRange(startOffset, textRange, matchSourceFormatting) | TextRange | Wstawia kopię podanego zakresu tekstu od przesunięcia początkowego. |
insertText(startOffset, text) | TextRange | Wstawia tekst od przesunięcia początkowego. |
isEmpty() | Boolean | Zwraca true , jeśli w tym zakresie nie ma znaków, i zwraca false
w przeciwnym razie. |
replaceAllText(findText, replaceText) | Integer | Zastępuje wszystkie wystąpienia tekstu pasującego do znalezionego tekstu poleceniem zamiennym. |
replaceAllText(findText, replaceText, matchCase) | Integer | Zastępuje wszystkie wystąpienia tekstu pasującego do znalezionego tekstu poleceniem zamiennym. |
select() | void | Wybiera tylko element TextRange w aktywnej prezentacji i usuwa wszystkie poprzednie
wyboru. |
setText(newText) | TextRange | Ustawia tekst ograniczony tym zakresem powiązanego kształtu lub komórki tabeli. |
Szczegółowa dokumentacja
appendParagraph(text)
Dodaje akapit na końcu zakresu tekstowego. Akapit zachowuje styl na końcu bieżącego zakresu tekstowego.
Podany ciąg tekstowy jest dołączany jako akapit przez dodanie co najmniej jednego otaczającego znaku nowego wiersza w ciągu znaków.
Jeśli podany ciąg tekstowy zawiera znaki nowego wiersza (czyli akapity), zwrócony zostanie ostatni dodany akapit.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg, który ma zostać dołączony jako akapit. |
Powrót
Paragraph
– dołączony tekst Paragraph
.
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
appendRange(textRange)
Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstowego.
Formatowanie wstawionego tekstu będzie takie samo jak w tekście źródłowym.
Parametry
Nazwa | Typ | Opis |
---|---|---|
textRange | TextRange | Zakres tekstu do dołączenia. |
Powrót
TextRange
– zakres tekstowy reprezentujący dołączony tekst.
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
appendRange(textRange, matchSourceFormatting)
Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstowego.
Jeśli jest ustawione zgodnie z formatowaniem tekstu docelowego, AutoText
w podanym
są zastępowane renderowanymi wartościami. Ponadto wszelkie elementy nietekstowe w
podany zakres tekstu nie jest dołączany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
textRange | TextRange | Zakres tekstu do dołączenia. |
matchSourceFormatting | Boolean | Jeśli true , odpowiada formatowaniu tekstu źródłowego; jeśli
false , takie jak format tekstu docelowego. |
Powrót
TextRange
– zakres tekstowy reprezentujący dołączony tekst.
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
appendText(text)
Dołącza tekst na końcu zakresu tekstu. Tekst zachowywany jest na końcu elementu istniejący tekst.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg do dołączenia. |
Powrót
TextRange
– zakres tekstu reprezentujący dołączony tekst.
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
asRenderedString()
Zwraca wyrenderowany tekst ograniczony tym zakresem powiązanego kształtu lub komórki tabeli w do wyświetlania użytkownikom.
Elementy automatycznego tekstu, takie jak wygenerowane numery slajdów, są zastępowane renderowanymi wartościami. Wszystkie elementy inne niż tekstowe w zakresie są pomijane.
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
asString()
Zwraca nieprzetworzony tekst ograniczony do tego zakresu powiązanego kształtu lub komórki tabeli.
Elementy autotekstu, takie jak wygenerowane numery slajdów i wszystkie elementy nietekstowe w zakresie, są zastąpiono znakiem Unicode U+E907.
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
clear()
Usuwa tekst ograniczony tym zakresem.
Ponieważ cały tekst w kształtach i obiektach TableCell musi kończyć się znakiem nowego wiersza, ostatni nowy wiersz w tekst nie jest usuwany.
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
clear(startOffset, endOffset)
Usuwa tekst ograniczony przesunięciem początku i końca zakresu.
Ponieważ znak nowego wiersza musi kończyć się nowym wierszem, ostatni wiersz w tekście nie jest usuwany, nawet jeśli danych przesunięcia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego
aby określić indeks początkowy zakresu do wyczyszczenia. Przesunięcie początkowe musi mieć wartość
większe lub równe 0 i mniejsze lub równe endOffset . startOffset
musi być też mniejsza od długości bieżącego zakresu. |
endOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego
aby określić wyłączny indeks końcowy zakresu do wyczyszczenia. Pole endOffset musi być
co najmniej startOffset . Wartość endOffset musi też być mniejsza niż lub
jej długość jest równa długości bieżącego zakresu. |
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
find(pattern)
Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym. Wyszukiwanie jest wielkość liter ma znaczenie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
pattern | String | Wzorzec wyrażeń regularnych do wyszukiwania; wszelkie odwrócone ukośniki we wzorcu powinny nie mają znaczenia. |
Powrót
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
find(pattern, startOffset)
Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym, począwszy od przesunięcie punktu początkowego. Wielkość liter w wyszukiwaniu ma znaczenie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
pattern | String | Wzorzec wyrażeń regularnych do wyszukiwania; wszelkie odwrócone ukośniki we wzorcu powinny nie mają znaczenia. |
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego
aby określić indeks początkowy zakresu do przeszukania. startOffset musi
być też mniejsza od długości bieżącego zakresu. |
Powrót
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
getAutoTexts()
Zwraca teksty automatyczne z bieżącego zakresu tekstu.
Powrót
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
getEndIndex()
Zwraca indeks wyłączny, oparty na 0 dla ostatniego znaku w tym zakresie. Jeśli początek i koniec indeksy są równe, zakres jest uznawany za pusty.
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
getLength()
Zwraca liczbę znaków w danym zakresie.
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
getLinks()
Zwraca zbiór zakresów tekstu, który odpowiada wszystkim elementom Link
w bieżącej
lub na bieżący zakres.
Każdy zwrócony zakres zawiera po utworzeniu 1 link. Modyfikacje tekstu może spowodować, że nie będzie już reprezentować jednego linku.
Dostęp do każdego elementu Link
w zwróconych zakresach można uzyskać poprzez TextStyle.getLink()
.
// Accesses the first link on a TextRange object. var linkTextRange = textRange.getLinks()[0]; var textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' var link = textStyle.getLink(); // Link object
Powrót
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
getListParagraphs()
Zwraca na listach akapity, które pokrywają się z bieżącym zakresem tekstowym.
Powrót
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
getListStyle()
getParagraphStyle()
Zwraca wartość ParagraphStyle
bieżącego zakresu tekstowego.
Powrót
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
getParagraphs()
Zwraca akapity, które nakładają się na bieżący zakres tekstu.
Powrót
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
getRange(startOffset, endOffset)
Zwraca nową funkcję TextRange
obejmującą część zakresu, z którego pochodzi.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego
aby określić indeks początkowy zwróconego zakresu. Przesunięcie początkowe musi mieć wartość
większe lub równe 0 i mniejsze lub równe endOffset . startOffset
musi być też mniejsza od długości bieżącego zakresu. |
endOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego
aby określić wyłączny indeks końcowy zwróconego zakresu. Pole endOffset musi być
co najmniej startOffset . Wartość endOffset musi też być mniejsza niż lub
jej długość jest równa długości bieżącego zakresu. |
Powrót
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
getRuns()
Zwraca fragmenty tekstu, które nakładają się na bieżący zakres tekstu. Uruchomienie tekstu to segment tekstu gdzie wszystkie znaki mają taki sam styl tekstu.
Każdy zwrócony zakres może obejmować tylko 1 uruchomienie podczas jego tworzenia. Tekst lub styl modyfikacje mogą spowodować, że nie będzie już reprezentować dokładnie 1 uruchomienia.
Powrót
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
getStartIndex()
Zwraca indeks zaczynający się od 0 dla pierwszego znaku w tym zakresie. Jeśli start oraz indeksy końcowe są równe, zakres jest uważany za pusty.
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
getTextStyle()
insertParagraph(startOffset, text)
Wstawia akapit od miejsca początkowego. Styl akapitu zachowuje aktualny styl zakresu tekstu.
Podany ciąg tekstowy jest wstawiany jako akapit przez dodanie co najmniej jednego otaczającego znaku nowego wiersza w ciągu znaków.
Jeśli podany ciąg tekstowy zawiera znaki nowego wiersza (czyli akapity), zwrócony zostanie ostatni dodany akapit.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia. |
text | String | Ciąg do wstawienia. |
Powrót
Paragraph
– wstawiono Paragraph
.
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
insertRange(startOffset, textRange)
Wstawia kopię podanego zakresu tekstu od przesunięcia początkowego.
Formatowanie wstawionego tekstu będzie takie samo jak w tekście źródłowym.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia. |
textRange | TextRange | Zakres tekstu do wstawienia. |
Powrót
TextRange
– zakres tekstowy reprezentujący wstawiony tekst.
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
insertRange(startOffset, textRange, matchSourceFormatting)
Wstawia kopię podanego zakresu tekstu od przesunięcia początkowego.
Jeśli jest ustawione zgodnie z formatowaniem tekstu docelowego, AutoText
w podanym
są zastępowane renderowanymi wartościami. Ponadto wszelkie elementy nietekstowe w
podany zakres tekstu nie został wstawiony.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia. |
textRange | TextRange | Zakres tekstu do wstawienia. |
matchSourceFormatting | Boolean | Jeśli true , odpowiada formatowaniu tekstu źródłowego; jeśli
false , takie jak format tekstu docelowego. |
Powrót
TextRange
– zakres tekstowy reprezentujący wstawiony tekst.
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
insertText(startOffset, text)
Wstawia tekst od przesunięcia początkowego. Tekst zachowuje styl istniejącego tekstu na przesunięcie punktu początkowego.
Parametry
Nazwa | Typ | Opis |
---|---|---|
startOffset | Integer | Liczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia. |
text | String | Ciąg do wstawienia. |
Powrót
TextRange
– zakres tekstu reprezentujący wstawiony tekst.
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
isEmpty()
Zwraca true
, jeśli w tym zakresie nie ma znaków, i zwraca false
w przeciwnym razie.
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
replaceAllText(findText, replaceText)
Zastępuje wszystkie wystąpienia tekstu pasującego do znalezionego tekstu poleceniem zamiennym. Bierzemy pod uwagę wielkość liter niewrażliwe.
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do znalezienia. |
replaceText | String | Tekst, który ma zastąpić dopasowany tekst. |
Powrót
Integer
– liczba zmienionych wystąpień;
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
replaceAllText(findText, replaceText, matchCase)
Zastępuje wszystkie wystąpienia tekstu pasującego do znalezionego tekstu poleceniem zamiennym.
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do znalezienia. |
replaceText | String | Tekst, który ma zastąpić dopasowany tekst. |
matchCase | Boolean | W przypadku reguły true wielkość liter w wyszukiwaniu ma znaczenie. jeśli false , wyszukiwanie ma postać
wielkość liter nie jest rozróżniana. |
Powrót
Integer
– liczba zmienionych wystąpień;
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
select()
Wybiera tylko element TextRange
w aktywnej prezentacji i usuwa wszystkie poprzednie
wyboru.
Skrypt ma dostęp do wyboru użytkownika, który go uruchomił, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.
Ustawiono element nadrzędny Page
odpowiedniej wartości Shape
lub TableCell
.
jak current page selection
. Shape
lub TableCell
mają wartość selected page element
.
Selection
:
- .
- 1. Zakres tekstu. Użyj przycisku Zaznacz przy niepustym zakresie TextRange, aby wybrać zakres znaków.
- 2. Pozycja kursora – użyj pustego zakresu TextRange, aby umieścić kursor w wybranym indeksie.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText("Hello"); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();
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
-
setText(newText)
Ustawia tekst ograniczony tym zakresem powiązanego kształtu lub komórki tabeli. Tekst zachowuje wybierz styl początku istniejącego tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
newText | String | Ciąg, który zostanie ustawiony jako nowy tekst. |
Powrót
TextRange
– zakres tekstowy reprezentujący ustalony tekst.
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