Segment tekstu w Shape
lub Table
.
Jeśli używasz metod, które zmieniają sposób dopasowywania tekstu do kształtu, wszystkie ustawienia automatycznego dopasowywania zastosowane do kształtu zostaną dezaktywowane.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
append | Paragraph | Dodaje akapit na końcu zakresu tekstu. |
append | Text | Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu. |
append | Text | Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu. |
append | Text | Dodaje tekst na końcu zakresu tekstu. |
as | String | Zwraca tekst poddany renderowaniu w zakresie powiązanego kształtu lub komórki tabeli w formacie odpowiednim do wyświetlania użytkownikom. |
as | String | Zwraca tekst niesformatowany ograniczony przez ten zakres powiązanego kształtu lub komórki tabeli. |
clear() | void | Czyści tekst ograniczony przez ten zakres. |
clear(startOffset, endOffset) | void | Czyści tekst ograniczony przez offset początkowy i końcowy w zakresie. |
find(pattern) | Text | Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym. |
find(pattern, startOffset) | Text | Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym, zaczynając od offsetu początkowego. |
get | Auto | Zwraca teksty automatyczne w bieżącym zakresie tekstowym. |
get | Integer | Zwraca indeks (zliczany od 0) ostatniego znaku w tym zakresie. |
get | Integer | Zwraca liczbę znaków w tym zakresie. |
get | Text | Zwraca zbiór zakresów tekstowych, które odpowiadają wszystkim elementom Link w bieżącym zakresie tekstowym lub na nim nakładającymi się. |
get | Paragraph[] | Zwraca akapity w listach, które zachodzą na bieżący zakres tekstu. |
get | List | Zwraca List bieżącego zakresu tekstowego. |
get | Paragraph | Zwraca Paragraph bieżącego zakresu tekstowego. |
get | Paragraph[] | Zwraca akapity, które zachodzą na bieżący zakres tekstu. |
get | Text | Zwraca nowy element Text obejmujący część zakresu, z którego został utworzony. |
get | Text | Zwraca ciągi tekstowe, które nakładają się na bieżący zakres tekstu. |
get | Integer | Zwraca indeks (z licznikiem 0) pierwszego znaku w tym zakresie. |
get | Text | Zwraca styl tekstu zakresu lub null , jeśli zakres jest pusty. |
insert | Paragraph | Wstawia akapit na początku przesunięcia. |
insert | Text | Wstawia kopię podanego zakresu tekstu w miejscu offsetu początkowego. |
insert | Text | Wstawia kopię podanego zakresu tekstu w miejscu offsetu początkowego. |
insert | Text | Wstawia tekst w początkowym przesunięciu. |
is | Boolean | Zwraca wartość true , jeśli w tym zakresie nie ma znaków, a w przeciwnym razie zwraca wartość false . |
replace | Integer | Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. |
replace | Integer | Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. |
select() | void | Wybiera tylko Text w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia. |
set | Text | Ustawia tekst ograniczony przez ten zakres w powiązanym kształcie lub komórce tabeli. |
Szczegółowa dokumentacja
append Paragraph(text)
Dodaje akapit na końcu zakresu tekstu. Akapit zachowuje stylizację końca bieżącego zakresu tekstu.
Podany ciąg tekstowy jest dołączany jako akapit przez dodanie co najmniej 1 znaku nowej linii.
Jeśli podany ciąg tekstowy zawiera znaki nowego wiersza (czyli składa się z kilku akapitów), zwracany jest ostatni dodany akapit.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg do dołączenia jako akapit. |
Powrót
Paragraph
– dołączony Paragraph
.
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
append Range(textRange)
Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu.
Formatowanie wstawionego tekstu będzie takie samo jak w tekście źródłowym.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Zakres tekstu, który chcesz dodać. |
Powrót
Text
– zakres tekstu reprezentujący dołączony tekst
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
append Range(textRange, matchSourceFormatting)
Dodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu.
Jeśli ustawisz opcję dopasowania formatowania do tekstu docelowego, wartości Auto
w podanym zakresie tekstu zostaną zastąpione ich renderowanymi wartościami. Ponadto nie są dołączane żadne elementy nietekstowe z podanego zakresu tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Zakres tekstu, który chcesz dodać. |
match | Boolean | Jeśli true , dopasuj formatowanie do tekstu źródłowego; jeśli false , dopasuj formatowanie do tekstu docelowego. |
Powrót
Text
– zakres tekstu reprezentujący dołączony tekst
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
append Text(text)
Dodaje tekst na końcu zakresu tekstu. Tekst zachowuje styl końca dotychczasowego tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg znaków do dołączenia. |
Powrót
Text
– zakres tekstu reprezentujący dołączony tekst.
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
as Rendered String()
Zwraca tekst poddany renderowaniu w zakresie powiązanego kształtu lub komórki tabeli w formacie odpowiednim do wyświetlania użytkownikom.
Auto
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
as String()
Zwraca tekst niesformatowany ograniczony przez ten zakres powiązanego kształtu lub komórki tabeli.
Auto
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
clear()
Czyści tekst ograniczony przez ten zakres.
Ponieważ cały tekst w kształcie lub komórce tabeli musi kończyć się znakiem końca wiersza, ostatni znak końca wiersza w tekście nie jest usuwany.
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
clear(startOffset, endOffset)
Czyści tekst ograniczony przez offset początkowy i końcowy w zakresie.
Tekst musi się kończyć znakiem nowego wiersza, więc ostatnia taka pozycja w tekście nie jest usuwana, nawet jeśli jest objęta podanymi przesunięciami.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, który służy do określenia indeksu początkowego zakresu (włącznie) do wyczyszczenia. Przesunięcie początkowe musi być równe lub większe od 0 i nie większe niż end . start musi być też krótszy niż długość bieżącego zakresu. |
end | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, który służy do określenia indeksu końcowego zakresu (bez niego). Wartość w polu end musi być równa lub większa niż start . Wartość end musi być mniejsza lub równa długości bieżącego zakresu. |
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
find(pattern)
Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstu. W wyszukiwaniu wielkość liter ma znaczenie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
pattern | String | Wzorzec wyrażenia regularnego, w którym ma być przeprowadzone wyszukiwanie. Wzorzec powinien być zapisany z użyciem znaku ucieczki. |
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
find(pattern, startOffset)
Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym, zaczynając od offsetu początkowego. W wyszukiwaniu rozróżniana jest wielkość liter.
Parametry
Nazwa | Typ | Opis |
---|---|---|
pattern | String | Wzorzec wyrażenia regularnego, w którym ma być przeprowadzone wyszukiwanie. Wzorzec powinien być zapisany z użyciem znaku ucieczki. |
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, który służy do określenia indeksu początkowego zakresu z uwzględnieniem zakresu. Wartość start musi być mniejsza od długości bieżącego zakresu. |
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 Auto Texts()
Zwraca teksty automatyczne w bieżącym zakresie tekstowym.
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 End Index()
Zwraca indeks (zliczany od 0) ostatniego znaku w tym zakresie. Jeśli indeksy początkowy i końcowy są równe, zakres jest uważany za pusty.
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 Length()
Zwraca liczbę znaków w tym zakresie.
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 Links()
Zwraca zbiór zakresów tekstowych, które odpowiadają wszystkim elementom Link
w bieżącym zakresie tekstowym lub na nim nakładającymi się.
Każdy zwracany zakres obejmuje tylko jeden link w momencie jego utworzenia. Modyfikacje tekstu mogą spowodować, że nie będzie on już reprezentować dokładnie jednego linku.
Do każdego Link
z zwróconych zakresów można uzyskać dostęp za pomocą Text
.
// Accesses the first link on a TextRange object. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); const linkTextRange = textRange.getLinks()[0]; const textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' const link = textStyle.getLink(); // Link object
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 List Paragraphs()
Zwraca akapity w listach, które zachodzą na bieżący zakres tekstu.
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 List Style()
get Paragraph Style()
Zwraca Paragraph
bieżącego zakresu tekstowego.
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 Paragraphs()
Zwraca akapity, które zachodzą na bieżący zakres tekstu.
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 Range(startOffset, endOffset)
Zwraca nowy element Text
obejmujący część zakresu, z którego został utworzony.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, który służy do określenia indeksu początkowego z zawieranym zakresem zwracanego zakresu. Przesunięcie początkowe musi być równe lub większe od 0 i nie większe niż end . start musi być też krótszy niż długość bieżącego zakresu. |
end | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, która służy do określenia indeksu końcowego zwracanego zakresu. Wartość w polu end musi być równa lub większa niż start . Wartość end musi być mniejsza lub równa długości bieżącego zakresu. |
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 Runs()
Zwraca ciągi tekstowe, które nakładają się na bieżący zakres tekstu. Tekst ciągu to segment tekstu, w którym wszystkie znaki mają ten sam styl.
Każdy zwracany zakres obejmuje tylko 1 wykonanie w momencie utworzenia. Modyfikacje tekstu lub stylu mogą spowodować, że nie będzie on już reprezentować dokładnie jednego przebiegu.
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 Start Index()
Zwraca indeks (z licznikiem 0) pierwszego znaku w tym zakresie. Jeśli indeksy początku i końca są równe, zakres jest uważany za pusty.
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 Text Style()
insert Paragraph(startOffset, text)
Wstawia akapit na początku przesunięcia. Akapit zachowuje styl bieżącego zakresu tekstu w offsetzie początkowym.
Podany ciąg tekstowy jest wstawiany jako akapit przez dodanie do niego co najmniej 1 znaku nowej linii.
Jeśli podany ciąg tekstowy zawiera znaki nowego wiersza (czyli składa się z kilku akapitów), zwracany jest ostatni dodany akapit.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, która służy do określenia indeksu początkowego (z uwzględnieniem znaków) tekstu do wstawienia. |
text | String | Ciąg znaków do wstawienia. |
Powrót
Paragraph
– wstawiony element Paragraph
.
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
insert Range(startOffset, textRange)
Wstawia kopię podanego zakresu tekstu w miejscu offsetu początkowego.
Formatowanie wstawionego tekstu będzie takie samo jak w tekście źródłowym.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, która służy do określenia indeksu początkowego (z uwzględnieniem znaków) tekstu do wstawienia. |
text | Text | Zakres tekstu do wstawienia. |
Powrót
Text
– zakres tekstu reprezentujący wstawiony tekst
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
insert Range(startOffset, textRange, matchSourceFormatting)
Wstawia kopię podanego zakresu tekstu w miejscu offsetu początkowego.
Jeśli ustawisz opcję dopasowania formatowania do tekstu docelowego, wartości Auto
w podanym zakresie tekstu zostaną zastąpione ich renderowanymi wartościami. Ponadto nie są wstawiane żadne elementy nietekstowe w podanym zakresie tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, która służy do określenia indeksu początkowego (z uwzględnieniem znaków) tekstu do wstawienia. |
text | Text | Zakres tekstu do wstawienia. |
match | Boolean | Jeśli true , dopasuj formatowanie do tekstu źródłowego; jeśli false , dopasuj formatowanie do tekstu docelowego. |
Powrót
Text
– zakres tekstu reprezentujący wstawiony tekst
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
insert Text(startOffset, text)
Wstawia tekst w początkowym przesunięciu. Tekst zachowuje styl dotychczasowego tekstu w miejscu przesunięcia początkowego.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego, która służy do określenia indeksu początkowego (z uwzględnieniem znaków) tekstu do wstawienia. |
text | String | Ciąg znaków do wstawienia. |
Powrót
Text
– zakres tekstu reprezentujący wstawiony tekst.
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 Empty()
Zwraca wartość true
, jeśli w tym zakresie nie ma znaków, a w przeciwnym razie zwraca wartość 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
replace All Text(findText, replaceText)
Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. Wielkość liter nie ma znaczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
find | String | Tekst do znalezienia. |
replace | String | Tekst, który ma zastąpić dopasowany tekst. |
Powrót
Integer
– zmieniona liczba wystąpień
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
replace All Text(findText, replaceText, matchCase)
Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
find | String | Tekst do znalezienia. |
replace | String | Tekst, który ma zastąpić dopasowany tekst. |
match | Boolean | Jeśli true , wyszukiwanie uwzględnia wielkość liter; jeśli false , wielkość liter nie ma znaczenia. |
Powrót
Integer
– zmieniona liczba wystąpień
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
select()
Wybiera tylko Text
w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia.
Skrypt może uzyskać dostęp tylko do elementów wybranych przez użytkownika, który go uruchamia, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.
Rodzic Page
odpowiadającego mu Shape
lub Table
jest ustawiony jako current page selection
. Shape
lub Table
jest ustawiony jako selected page element
.
Selection
może być 2 typów:
- 1. Zakres tekstu – użyj funkcji select na niepustym zakresie tekstu, aby wybrać zakres znaków.
- 2. Pozycja kursora – użyj pustego zakresu tekstu, aby umieścić kursor w pożądanym indeksie.
const 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, 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 Text(newText)
Ustawia tekst ograniczony przez ten zakres w powiązanym kształcie lub komórce tabeli. Tekst zachowuje styl początku dotychczasowego tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
new | String | Ciąg znaków, który ma być ustawiony jako nowy tekst. |
Powrót
Text
– zakres tekstu reprezentujący ustawiony tekst.
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