Class TextRange

TextRange

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

MetodaZwracany typKrótki opis
appendParagraph(text)ParagraphDodaje akapit na końcu zakresu tekstowego.
appendRange(textRange)TextRangeDodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstowego.
appendRange(textRange, matchSourceFormatting)TextRangeDodaje kopię podanego zakresu tekstu na końcu bieżącego zakresu tekstowego.
appendText(text)TextRangeDołącza tekst na końcu zakresu tekstu.
asRenderedString()StringZwraca wyrenderowany tekst ograniczony tym zakresem powiązanego kształtu lub komórki tabeli w do wyświetlania użytkownikom.
asString()StringZwraca nieprzetworzony tekst ograniczony do tego zakresu powiązanego kształtu lub komórki tabeli.
clear()voidUsuwa tekst ograniczony tym zakresem.
clear(startOffset, endOffset)voidUsuwa 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()IntegerZwraca indeks wyłączny, oparty na 0 dla ostatniego znaku w tym zakresie.
getLength()IntegerZwraca 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()ListStyleZwraca wartość ListStyle bieżącego zakresu tekstowego.
getParagraphStyle()ParagraphStyleZwraca wartość ParagraphStyle bieżącego zakresu tekstowego.
getParagraphs()Paragraph[]Zwraca akapity, które nakładają się na bieżący zakres tekstu.
getRange(startOffset, endOffset)TextRangeZwraca 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()IntegerZwraca indeks zaczynający się od 0 dla pierwszego znaku w tym zakresie.
getTextStyle()TextStyleZwraca styl tekstu zakresu lub null, jeśli zakres jest pusty.
insertParagraph(startOffset, text)ParagraphWstawia akapit od miejsca początkowego.
insertRange(startOffset, textRange)TextRangeWstawia kopię podanego zakresu tekstu od przesunięcia początkowego.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeWstawia kopię podanego zakresu tekstu od przesunięcia początkowego.
insertText(startOffset, text)TextRangeWstawia tekst od przesunięcia początkowego.
isEmpty()BooleanZwraca true, jeśli w tym zakresie nie ma znaków, i zwraca false w przeciwnym razie.
replaceAllText(findText, replaceText)IntegerZastępuje wszystkie wystąpienia tekstu pasującego do znalezionego tekstu poleceniem zamiennym.
replaceAllText(findText, replaceText, matchCase)IntegerZastępuje wszystkie wystąpienia tekstu pasującego do znalezionego tekstu poleceniem zamiennym.
select()voidWybiera tylko element TextRange w aktywnej prezentacji i usuwa wszystkie poprzednie wyboru.
setText(newText)TextRangeUstawia 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

NazwaTypOpis
textStringCią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

NazwaTypOpis
textRangeTextRangeZakres 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

NazwaTypOpis
textRangeTextRangeZakres tekstu do dołączenia.
matchSourceFormattingBooleanJeś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

NazwaTypOpis
textStringCią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

NazwaTypOpis
startOffsetIntegerLiczba 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.
endOffsetIntegerLiczba 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

NazwaTypOpis
patternStringWzorzec wyrażeń regularnych do wyszukiwania; wszelkie odwrócone ukośniki we wzorcu powinny nie mają znaczenia.

Powrót

TextRange[]

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

NazwaTypOpis
patternStringWzorzec wyrażeń regularnych do wyszukiwania; wszelkie odwrócone ukośniki we wzorcu powinny nie mają znaczenia.
startOffsetIntegerLiczba 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

TextRange[]

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

AutoText[]

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

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

TextRange[]

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

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

getListStyle()

Zwraca wartość ListStyle bieżącego zakresu tekstowego.

Powrót

ListStyle

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

getParagraphStyle()

Zwraca wartość ParagraphStyle bieżącego zakresu tekstowego.

Powrót

ParagraphStyle

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

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

getRange(startOffset, endOffset)

Zwraca nową funkcję TextRange obejmującą część zakresu, z którego pochodzi.

Parametry

NazwaTypOpis
startOffsetIntegerLiczba 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.
endOffsetIntegerLiczba 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

TextRange

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

TextRange[]

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()

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

Powrót

TextStyle

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

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

NazwaTypOpis
startOffsetIntegerLiczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia.
textStringCią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

NazwaTypOpis
startOffsetIntegerLiczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia.
textRangeTextRangeZakres 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

NazwaTypOpis
startOffsetIntegerLiczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia.
textRangeTextRangeZakres tekstu do wstawienia.
matchSourceFormattingBooleanJeś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

NazwaTypOpis
startOffsetIntegerLiczba znaków poza indeksem początkowym używanego zakresu tekstowego aby określić inkluzywny indeks początkowy tekstu do wstawienia.
textStringCią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

NazwaTypOpis
findTextStringTekst do znalezienia.
replaceTextStringTekst, 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

NazwaTypOpis
findTextStringTekst do znalezienia.
replaceTextStringTekst, który ma zastąpić dopasowany tekst.
matchCaseBooleanW 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.

    Dostępne są 2 typy parametrów 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

    NazwaTypOpis
    newTextStringCią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