Class TextRange

Segment treści tekstowych w Shape lub TableCell.

Jeśli używasz metod, które zmieniają sposób dopasowania tekstu do kształtu, wszystkie ustawienia automatycznego dopasowywania zastosowane do kształtu zostaną wyłączone.

Metody

Metoda	Zwracany typ	Krótki opis
`appendParagraph(text)`	`Paragraph`	Dodaje akapit na końcu zakresu tekstu.
`appendRange(textRange)`	`TextRange`	Dołącza kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Dołącza kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu.
`appendText(text)`	`TextRange`	Dołącza tekst na końcu zakresu tekstu.
`asRenderedString()`	`String`	Zwraca renderowany tekst ograniczony tym zakresem w powiązanym kształcie lub komórce tabeli w formacie odpowiednim do wyświetlania użytkownikom.
`asString()`	`String`	Zwraca tekst w formie surowej ograniczony tym zakresem w przypadku powiązanego kształtu lub komórki tabeli.
`clear()`	`void`	Usuwa tekst w tym zakresie.
`clear(startOffset, endOffset)`	`void`	Usuwa tekst ograniczony przez offsety początkowy i końcowy w zakresie.
`find(pattern)`	`TextRange[]`	Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstu.
`find(pattern, startOffset)`	`TextRange[]`	Zwraca wszystkie zakresy pasujące do wzorca wyszukiwania w bieżącym zakresie tekstowym, zaczynając od offsetu początkowego.
`getAutoTexts()`	`AutoText[]`	Zwraca automatyczne teksty w bieżącym zakresie tekstu.
`getEndIndex()`	`Integer`	Zwraca wyłączny indeks ostatniego znaku w tym zakresie (liczony od zera).
`getLength()`	`Integer`	Zwraca liczbę znaków w tym zakresie.
`getLinks()`	`TextRange[]`	Zwraca zbiór zakresów tekstu, które odpowiadają wszystkim znakom `Link` w bieżącym zakresie tekstu lub nakładającym się na niego.
`getListParagraphs()`	`Paragraph[]`	Zwraca akapity na listach, które pokrywają się z bieżącym zakresem tekstu.
`getListStyle()`	`ListStyle`	Zwraca `ListStyle` bieżącego zakresu tekstu.
`getParagraphStyle()`	`ParagraphStyle`	Zwraca `ParagraphStyle` bieżącego zakresu tekstu.
`getParagraphs()`	`Paragraph[]`	Zwraca akapity, które pokrywają się z bieżącym zakresem tekstu.
`getRange(startOffset, endOffset)`	`TextRange`	Zwraca nowy obiekt `TextRange` obejmujący 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 pierwszego znaku w tym zakresie (włącznie), rozpoczynający się od 0.
`getTextStyle()`	`TextStyle\|null`	Zwraca styl tekstu w zakresie lub `null`, jeśli zakres jest pusty.
`insertParagraph(startOffset, text)`	`Paragraph`	Wstawia akapit na początku przesunięcia.
`insertRange(startOffset, textRange)`	`TextRange`	Wstawia kopię podanego zakresu tekstu w miejscu offsetu początkowego.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Wstawia kopię podanego zakresu tekstu w miejscu offsetu początkowego.
`insertText(startOffset, text)`	`TextRange`	Wstawia tekst na początku przesunięcia.
`isEmpty()`	`Boolean`	Zwraca wartość `true`, jeśli w tym zakresie nie ma znaków, a w przeciwnym razie zwraca wartość `false`.
`replaceAllText(findText, replaceText)`	`Integer`	Zamienia wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia na tekst do zamiany.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Zamienia wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia na tekst do zamiany.
`select()`	`void`	Zaznacza tylko element `TextRange` w aktywnej prezentacji i usuwa poprzedni wybór.
`setText(newText)`	`TextRange`	Ustawia tekst ograniczony tym zakresem w powiązanym kształcie lub komórce tabeli.

Szczegółowa dokumentacja

`appendParagraph(text)`

Dodaje akapit na końcu zakresu tekstu. Akapit zachowuje styl końca bieżącego zakresu tekstu.

Podany ciąg tekstowy jest dołączany jako akapit przez dodanie do niego co najmniej jednego znaku nowego wiersza.

Jeśli podany ciąg tekstowy zawiera znaki nowego wiersza (a więc składa się z kilku akapitów), zwracany jest ostatni dodany akapit.

Parametry

Nazwa	Typ	Opis
`text`	`String`	Ciąg znaków do dołączenia jako akapit.

Powrót

Paragraph– Dołączony Paragraph.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`appendRange(textRange)`

Dołącza kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu.

Formatowanie wstawionego tekstu jest zgodne z formatowaniem tekstu źródłowego.

Parametry

Nazwa	Typ	Opis
`textRange`	`TextRange`	Zakres tekstu do dodania.

Powrót

TextRange – zakres tekstu reprezentujący dołączony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`appendRange(textRange, matchSourceFormatting)`

Dołącza kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstu.

Jeśli ustawisz dopasowanie do formatowania tekstu docelowego, znaki AutoText w podanym zakresie tekstu zostaną zastąpione ich renderowanymi wartościami. Ponadto nie są dołączane żadne elementy inne niż tekst w podanym zakresie tekstu.

Parametry

Nazwa	Typ	Opis
`textRange`	`TextRange`	Zakres tekstu do dodania.
`matchSourceFormatting`	`Boolean`	Jeśli `true`, dopasuj formatowanie tekstu źródłowego; jeśli `false`, dopasuj formatowanie tekstu docelowego.

Powrót

TextRange – zakres tekstu reprezentujący dołączony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 zachowuje styl końca istniejącego tekstu.

Parametry

Nazwa	Typ	Opis
`text`	`String`	Ciąg znaków do dołączenia.

Powrót

TextRange – zakres tekstu reprezentujący dołączony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`asRenderedString()`

Zwraca renderowany tekst ograniczony tym zakresem w powiązanym kształcie lub komórce tabeli w formacie odpowiednim do wyświetlania użytkownikom.

Elementy autotekstu, takie jak wygenerowane numery slajdów, są zastępowane ich renderowanymi wartościami. Wszystkie elementy inne niż tekstowe w zakresie są pomijane.

Powrót

String – renderowany tekst w zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`asString()`

Zwraca tekst w formie surowej ograniczony tym zakresem w przypadku powiązanego kształtu lub komórki tabeli.

Elementy Autotekstu, takie jak wygenerowane numery slajdów i wszystkie elementy inne niż tekstowe w zakresie, są zastępowane znakiem Unicode U+E907.

Powrót

String – surowy tekst w zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`clear()`

Usuwa tekst w tym zakresie.

Ponieważ cały tekst w obiekcie Shape lub TableCell musi kończyć się znakiem nowego wiersza, ostatni znak nowego wiersza w tekście nie jest usuwany.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`clear(startOffset, endOffset)`

Usuwa tekst ograniczony przez offsety początkowy i końcowy w zakresie.

Ponieważ tekst musi się kończyć znakiem nowego wiersza, ostatni znak nowego wiersza w tekście nie jest usuwany, nawet jeśli jest objęty podanymi przesunięciami.

Parametry

Nazwa	Typ	Opis
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania indeksu początkowego zakresu do wyczyszczenia (włącznie). Przesunięcie początkowe musi być większe lub równe 0 i mniejsze lub równe `endOffset`. `startOffset` musi być też mniejsza niż długość bieżącego zakresu.
`endOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania wyłącznego indeksu końcowego zakresu do wyczyszczenia. Wartość w polu `endOffset` musi być równa lub większa niż `startOffset`. Wartość `endOffset` musi być też mniejsza lub równa długości bieżącego zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. Wyszukiwanie uwzględnia wielkość liter.

Parametry

Nazwa	Typ	Opis
`pattern`	`String`	Wzorzec wyrażenia regularnego do wyszukania. Wszystkie ukośniki odwrotne we wzorcu powinny być poprzedzone znakiem ucieczki.

Powrót

TextRange[] – lista zakresów tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 jest rozróżniana wielkość liter.

Parametry

Nazwa	Typ	Opis
`pattern`	`String`	Wzorzec wyrażenia regularnego do wyszukania. Wszystkie ukośniki odwrotne we wzorcu powinny być poprzedzone znakiem ucieczki.
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określenia indeksu początkowego zakresu do wyszukiwania. Wartość `startOffset` musi być też mniejsza niż długość bieżącego zakresu.

Powrót

TextRange[] – lista zakresów tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getAutoTexts()`

Zwraca automatyczne teksty w bieżącym zakresie tekstu.

Powrót

AutoText[] – lista tekstów automatycznych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getEndIndex()`

Zwraca wyłączny indeks ostatniego znaku w tym zakresie (liczony od zera). Jeśli indeksy początkowy i końcowy są równe, zakres jest uznawany za pusty.

Powrót

Integer – indeks końcowy zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLength()`

Zwraca liczbę znaków w tym zakresie.

Powrót

Integer – liczba znaków w tym zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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óre odpowiadają wszystkim znakom Link w bieżącym zakresie tekstu lub nakładającym się na niego.

Każdy zwrócony zakres obejmuje 1 link w momencie jego utworzenia. Modyfikacje tekstu mogą spowodować, że nie będzie on już reprezentować dokładnie jednego linku.

Do każdego elementu Link w zwróconych zakresach można uzyskać dostęp za pomocą elementu TextStyle.getLink().

// 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

TextRange[] – lista zakresów tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getListParagraphs()`

Zwraca akapity na listach, które pokrywają się z bieżącym zakresem tekstu.

Powrót

Paragraph[] – lista akapitów na listach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getListStyle()`

Zwraca ListStyle bieżącego zakresu tekstu.

Powrót

ListStyle – styl listy bieżącego zakresu tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParagraphStyle()`

Zwraca ParagraphStyle bieżącego zakresu tekstu.

Powrót

ParagraphStyle – styl akapitu bieżącego zakresu tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParagraphs()`

Zwraca akapity, które pokrywają się z bieżącym zakresem tekstu.

Powrót

Paragraph[] – lista akapitów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRange(startOffset, endOffset)`

Zwraca nowy obiekt TextRange obejmujący część zakresu, z którego pochodzi.

Parametry

Nazwa	Typ	Opis
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania indeksu początkowego zwracanego zakresu (włącznie). Przesunięcie początkowe musi być większe lub równe 0 i mniejsze lub równe `endOffset`. `startOffset` musi być też mniejsza niż długość bieżącego zakresu.
`endOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określenia wyłącznego indeksu końcowego zwracanego zakresu. Wartość w polu `endOffset` musi być równa lub większa niż `startOffset`. Wartość `endOffset` musi być też mniejsza lub równa długości bieżącego zakresu.

Powrót

TextRange – nowy zakres tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. Ciąg tekstowy to segment tekstu, w którym wszystkie znaki mają ten sam styl tekstu.

Każdy zwrócony zakres obejmuje tylko jeden przebieg w momencie jego utworzenia. Zmiany tekstu lub stylu mogą spowodować, że nie będzie on już reprezentować dokładnie jednego przebiegu.

Powrót

TextRange[] – lista zakresów tekstu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getStartIndex()`

Zwraca indeks pierwszego znaku w tym zakresie (włącznie), rozpoczynający się od 0. Jeśli indeksy początkowy i końcowy są równe, zakres jest uznawany za pusty.

Powrót

Integer – indeks początkowy zakresu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTextStyle()`

Zwraca styl tekstu w zakresie lub null, jeśli zakres jest pusty.

Powrót

TextStyle|null – styl tekstu w zakresie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertParagraph(startOffset, text)`

Wstawia akapit na początku przesunięcia. Akapit zachowuje styl bieżącego zakresu tekstu przy przesunięciu początkowym.

Podany ciąg tekstowy jest wstawiany jako akapit przez dodanie do niego co najmniej jednego znaku nowego wiersza.

Jeśli podany ciąg tekstowy zawiera znaki nowego wiersza (a więc składa się z kilku akapitów), zwracany jest ostatni dodany akapit.

Parametry

Nazwa	Typ	Opis
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania indeksu początkowego tekstu do wstawienia (włącznie).
`text`	`String`	Ciąg znaków do wstawienia.

Powrót

Paragraph – wstawiony Paragraph.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w miejscu offsetu początkowego.

Formatowanie wstawionego tekstu jest zgodne z formatowaniem tekstu źródłowego.

Parametry

Nazwa	Typ	Opis
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania indeksu początkowego tekstu do wstawienia (włącznie).
`textRange`	`TextRange`	Zakres tekstu do wstawienia.

Powrót

TextRange – zakres tekstu reprezentujący wstawiony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w miejscu offsetu początkowego.

Jeśli ustawisz dopasowanie do formatowania tekstu docelowego, znaki AutoText w podanym zakresie tekstu zostaną zastąpione ich renderowanymi wartościami. Ponadto nie są wstawiane żadne elementy inne niż tekstowe w podanym zakresie tekstu.

Parametry

Nazwa	Typ	Opis
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania indeksu początkowego tekstu do wstawienia (włącznie).
`textRange`	`TextRange`	Zakres tekstu do wstawienia.
`matchSourceFormatting`	`Boolean`	Jeśli `true`, dopasuj formatowanie tekstu źródłowego; jeśli `false`, dopasuj formatowanie tekstu docelowego.

Powrót

TextRange – zakres tekstu reprezentujący wstawiony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertText(startOffset, text)`

Wstawia tekst na początku przesunięcia. Tekst zachowuje styl istniejącego tekstu w pozycji początkowej.

Parametry

Nazwa	Typ	Opis
`startOffset`	`Integer`	Liczba znaków po indeksie początkowym bieżącego zakresu tekstowego używana do określania indeksu początkowego tekstu do wstawienia (włącznie).
`text`	`String`	Ciąg znaków do wstawienia.

Powrót

TextRange – zakres tekstu reprezentujący wstawiony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isEmpty()`

Zwraca wartość true, jeśli w tym zakresie nie ma znaków, a w przeciwnym razie zwraca wartość false.

Powrót

Boolean – true, jeśli w tym zakresie nie ma znaków, a w przeciwnym razie zwraca false.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceAllText(findText, replaceText)`

Zamienia wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia na tekst do zamiany. Wyszukiwanie nie uwzględnia wielkości liter.

Parametry

Nazwa	Typ	Opis
`findText`	`String`	Tekst do znalezienia.
`replaceText`	`String`	Tekst, którym chcesz zastąpić dopasowany tekst.

Powrót

Integer – liczba wystąpień uległa zmianie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceAllText(findText, replaceText, matchCase)`

Zamienia wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia na tekst do zamiany.

Parametry

Nazwa	Typ	Opis
`findText`	`String`	Tekst do znalezienia.
`replaceText`	`String`	Tekst, którym chcesz zastąpić dopasowany tekst.
`matchCase`	`Boolean`	Jeśli `true`, wyszukiwanie uwzględnia wielkość liter, a jeśli `false` – nie.

Powrót

Integer – liczba wystąpień uległa zmianie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

Zaznacza tylko element TextRange w aktywnej prezentacji i usuwa poprzedni wybór.

Skrypt może uzyskać dostęp do zaznaczenia użytkownika, który go uruchamia, tylko wtedy, gdy jest powiązany z prezentacją.

Element nadrzędny Page odpowiedniego elementu Shape lub TableCell jest ustawiony jako current page selection. Shape lub TableCell jest ustawione jako selected page element.

Selection może być 2 rodzajów:

1. Zakres tekstu: użyj opcji zaznaczania w niepustym obiekcie TextRange, aby zaznaczyć zakres znaków.
2. Pozycja kursora: użyj pustego obiektu TextRange, aby umieścić kursor w odpowiednim 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
- https://www.googleapis.com/auth/presentations.currentonly
- https://www.googleapis.com/auth/presentations

`setText(newText)`

Ustawia tekst ograniczony tym zakresem w powiązanym kształcie lub komórce tabeli. Tekst zachowuje styl początku istniejącego tekstu.

Parametry

Nazwa	Typ	Opis
`newText`	`String`	Ciąg znaków, który ma zostać ustawiony jako nowy tekst.

Powrót

TextRange – zakres tekstu reprezentujący ustawiony tekst.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

Class TextRange Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Szczegółowa dokumentacja

appendParagraph(text)

Parametry

Powrót

Autoryzacja

appendRange(textRange)

Parametry

Powrót

Autoryzacja

appendRange(textRange, matchSourceFormatting)

Parametry

Powrót

Autoryzacja

appendText(text)

Parametry

Powrót

Autoryzacja

asRenderedString()

Powrót

Autoryzacja

asString()

Powrót

Autoryzacja

clear()

Autoryzacja

clear(startOffset, endOffset)

Parametry

Autoryzacja

find(pattern)

Parametry

Powrót

Autoryzacja

find(pattern, startOffset)

Parametry

Powrót

Autoryzacja

getAutoTexts()

Powrót

Autoryzacja

getEndIndex()

Powrót

Autoryzacja

getLength()

Powrót

Autoryzacja

getLinks()

Powrót

Autoryzacja

getListParagraphs()

Powrót

Autoryzacja

getListStyle()

Powrót

Autoryzacja

getParagraphStyle()

Powrót

Autoryzacja

getParagraphs()

Powrót

Autoryzacja

getRange(startOffset, endOffset)

Parametry

Powrót

Autoryzacja

getRuns()

Powrót

Autoryzacja

getStartIndex()

Powrót

Autoryzacja

getTextStyle()

Powrót

Autoryzacja

insertParagraph(startOffset, text)

Parametry

Powrót

Autoryzacja

insertRange(startOffset, textRange)

Class TextRange

`appendParagraph(text)`

`appendRange(textRange)`

`appendRange(textRange, matchSourceFormatting)`

`appendText(text)`

`asRenderedString()`

`asString()`

`clear()`

`clear(startOffset, endOffset)`

`find(pattern)`

`find(pattern, startOffset)`

`getAutoTexts()`

`getEndIndex()`

`getLength()`

`getLinks()`

`getListParagraphs()`

`getListStyle()`

`getParagraphStyle()`

`getParagraphs()`

`getRange(startOffset, endOffset)`

`getRuns()`

`getStartIndex()`

`getTextStyle()`

`insertParagraph(startOffset, text)`

`insertRange(startOffset, textRange)`

`insertRange(startOffset, textRange, matchSourceFormatting)`

`insertText(startOffset, text)`

`isEmpty()`

`replaceAllText(findText, replaceText)`

`replaceAllText(findText, replaceText, matchCase)`

`select()`

`setText(newText)`