Class TextRange

TextRange

Ein Segment des Textinhalts eines Shape- oder TableCell-Elements.

Falls Sie Methoden verwenden, die verändern, wie Text an Formen angepasst wird, werden alle auf die Form angewendeten automatischen Anpassungen deaktiviert.

Methoden

MethodeRückgabetypKurzbeschreibung
appendParagraph(text)ParagraphFügt am Ende des Textbereichs einen Absatz an.
appendRange(textRange)TextRangeFügt eine Kopie des angegebenen Textbereichs am Ende des aktuellen Textbereichs an.
appendRange(textRange, matchSourceFormatting)TextRangeFügt eine Kopie des angegebenen Textbereichs am Ende des aktuellen Textbereichs an.
appendText(text)TextRangeFügt Text am Ende des Textbereichs an.
asRenderedString()StringGibt den gerenderten Text zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird, in einem Format, das für die Anzeige für Endnutzer geeignet ist.
asString()StringGibt den Roh-Text zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird.
clear()voidLöscht den Text, der durch diesen Bereich begrenzt wird.
clear(startOffset, endOffset)voidLöscht den Text, der durch den Start- und End-Offset im Bereich begrenzt wird.
find(pattern)TextRange[]Gibt alle Bereiche zurück, die dem Suchmuster im aktuellen Textbereich entsprechen.
find(pattern, startOffset)TextRange[]Gibt alle Bereiche zurück, die dem Suchmuster im aktuellen Textbereich ab dem Startversatz entsprechen.
getAutoTexts()AutoText[]Gibt die automatischen Texte im aktuellen Textbereich zurück.
getEndIndex()IntegerGibt den exklusiven, nullbasierten Index für das letzte Zeichen in diesem Bereich zurück.
getLength()IntegerGibt die Anzahl der Zeichen in diesem Bereich zurück.
getLinks()TextRange[]Gibt eine Sammlung von Textbereichen zurück, die allen Links innerhalb des aktuellen Textbereichs oder mit dem aktuellen Textbereich überlappend entsprechen.
getListParagraphs()Paragraph[]Gibt die Absätze in Listen zurück, die sich mit dem aktuellen Textbereich überschneiden.
getListStyle()ListStyleGibt den ListStyle des aktuellen Textbereichs zurück.
getParagraphStyle()ParagraphStyleGibt den ParagraphStyle des aktuellen Textbereichs zurück.
getParagraphs()Paragraph[]Gibt die Absätze zurück, die sich mit dem aktuellen Textbereich überschneiden.
getRange(startOffset, endOffset)TextRangeGibt einen neuen TextRange zurück, der einen Teil des Bereichs abdeckt, aus dem er abgeleitet wird.
getRuns()TextRange[]Gibt die Textläufe zurück, die sich mit dem aktuellen Textbereich überschneiden.
getStartIndex()IntegerGibt den 0-basierten Index für das erste Zeichen in diesem Bereich zurück (einschließlich).
getTextStyle()TextStyle|nullGibt die Textformatierung des Bereichs zurück oder null, wenn der Bereich leer ist.
insertParagraph(startOffset, text)ParagraphFügt einen Absatz am Start-Offset ein.
insertRange(startOffset, textRange)TextRangeFügt eine Kopie des angegebenen Textbereichs am Start-Offset ein.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeFügt eine Kopie des angegebenen Textbereichs am Start-Offset ein.
insertText(startOffset, text)TextRangeFügt Text am Start-Offset ein.
isEmpty()BooleanGibt true zurück, wenn in diesem Bereich keine Zeichen vorhanden sind, andernfalls false.
replaceAllText(findText, replaceText)IntegerErsetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“.
replaceAllText(findText, replaceText, matchCase)IntegerErsetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“.
select()voidWählt nur das TextRange in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen.
setText(newText)TextRangeLegt den Text fest, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird.

Detaillierte Dokumentation

appendParagraph(text)

Fügt am Ende des Textbereichs einen Absatz an. Der Absatz behält die Formatierung des Endes des aktuellen Textbereichs bei.

Der angegebene String wird als Absatz angehängt, indem dem String mindestens ein umgebendes Zeilenumbruchzeichen hinzugefügt wird.

Wenn der angegebene Textstring Zeilenumbruchzeichen enthält und somit aus mehreren Absätzen besteht, wird der zuletzt hinzugefügte Absatz zurückgegeben.

Parameter

NameTypBeschreibung
textStringDie Zeichenfolge, die als Absatz angehängt werden soll.

Rückflug

Paragraph – Die angehängte Paragraph.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendRange(textRange)

Fügt eine Kopie des angegebenen Textbereichs am Ende des aktuellen Textbereichs an.

Die Formatierung des eingefügten Texts entspricht der des Quelltexts.

Parameter

NameTypBeschreibung
textRangeTextRangeDer Textbereich, der angehängt werden soll.

Rückflug

TextRange: Der Textbereich, der den angehängten Text darstellt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendRange(textRange, matchSourceFormatting)

Fügt eine Kopie des angegebenen Textbereichs am Ende des aktuellen Textbereichs an.

Wenn diese Option so festgelegt ist, dass sie mit der Formatierung des Zieltexts übereinstimmt, werden AutoText im angegebenen Textbereich durch die gerenderten Werte ersetzt. Außerdem werden alle Nicht-Textelemente im angegebenen Textbereich nicht angehängt.

Parameter

NameTypBeschreibung
textRangeTextRangeDer Textbereich, der angehängt werden soll.
matchSourceFormattingBooleanBei true wird die Formatierung des Quelltexts übernommen, bei false die Formatierung des Zieltexts.

Rückflug

TextRange: Der Textbereich, der den angehängten Text darstellt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendText(text)

Fügt Text am Ende des Textbereichs an. Der Text behält die Formatierung des Endes des vorhandenen Texts bei.

Parameter

NameTypBeschreibung
textStringDer anzuhängende String.

Rückflug

TextRange: Der Textbereich, der den angehängten Text darstellt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

asRenderedString()

Gibt den gerenderten Text zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird, in einem Format, das für die Anzeige für Endnutzer geeignet ist.

AutoText-Elemente wie generierte Foliennummern werden durch ihre gerenderten Werte ersetzt. Alle Elemente, die keinen Text enthalten, werden im Bereich ausgelassen.

Rückflug

String: Der gerenderte Text im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

asString()

Gibt den Roh-Text zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird.

AutoText-Elemente wie generierte Foliennummern und alle Nicht-Text-Elemente im Bereich werden durch das Unicode-Zeichen U+E907 ersetzt.

Rückflug

String: Der Rohtext im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

clear()

Löscht den Text, der durch diesen Bereich begrenzt wird.

Da der gesamte Text in einem Shape oder einer TableCell mit einem Zeilenumbruch enden muss, wird der letzte Zeilenumbruch im Text nicht entfernt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

clear(startOffset, endOffset)

Löscht den Text, der durch den Start- und End-Offset im Bereich begrenzt wird.

Da der Text mit einem Zeilenumbruch enden muss, wird der letzte Zeilenumbruch im Text nicht entfernt, auch wenn er von den angegebenen Offsets abgedeckt wird.

Parameter

NameTypBeschreibung
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des zu löschenden Bereichs zu bestimmen. Der Start-Offset muss größer oder gleich 0 und kleiner oder gleich endOffset sein. startOffset muss auch kleiner als die Länge des aktuellen Bereichs sein.
endOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die zum Ermitteln des exklusiven Endindex des zu löschenden Bereichs verwendet werden. endOffset muss gleich oder größer als startOffset sein. endOffset muss auch kleiner oder gleich der Länge des aktuellen Bereichs sein.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

find(pattern)

Gibt alle Bereiche zurück, die dem Suchmuster im aktuellen Textbereich entsprechen. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

NameTypBeschreibung
patternStringDas Muster des regulären Ausdrucks, nach dem gesucht werden soll. Alle Backslashes im Muster müssen mit Escapezeichen versehen werden.

Rückflug

TextRange[] – Eine Liste von Textbereichen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

find(pattern, startOffset)

Gibt alle Bereiche zurück, die dem Suchmuster im aktuellen Textbereich ab dem Startversatz entsprechen. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

NameTypBeschreibung
patternStringDas Muster des regulären Ausdrucks, nach dem gesucht werden soll. Alle Backslashes im Muster müssen mit Escapezeichen versehen werden.
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des zu durchsuchenden Bereichs zu bestimmen. startOffset muss auch kleiner als die Länge des aktuellen Bereichs sein.

Rückflug

TextRange[] – Eine Liste von Textbereichen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getAutoTexts()

Gibt die automatischen Texte im aktuellen Textbereich zurück.

Rückflug

AutoText[]: Eine Liste mit automatischen Texten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getEndIndex()

Gibt den exklusiven, nullbasierten Index für das letzte Zeichen in diesem Bereich zurück. Wenn die Start- und Endindexe gleich sind, gilt der Bereich als leer.

Rückflug

Integer: Der Endindex des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLength()

Gibt die Anzahl der Zeichen in diesem Bereich zurück.

Rückflug

Integer: Die Anzahl der Zeichen in diesem Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Gibt eine Sammlung von Textbereichen zurück, die allen Links innerhalb des aktuellen Textbereichs oder mit dem aktuellen Textbereich überlappend entsprechen.

Jeder zurückgegebene Bereich umfasst garantiert einen Link, wenn er erstellt wird. Durch Textänderungen kann es passieren, dass der Link nicht mehr genau einen Link repräsentiert.

Auf jedes Link in den zurückgegebenen Bereichen kann über TextStyle.getLink() zugegriffen werden. 

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

Rückflug

TextRange[] – Eine Liste von Textbereichen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getListParagraphs()

Gibt die Absätze in Listen zurück, die sich mit dem aktuellen Textbereich überschneiden.

Rückflug

Paragraph[]: Eine Liste mit Absätzen in Listen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getListStyle()

Gibt den ListStyle des aktuellen Textbereichs zurück.

Rückflug

ListStyle – Der Listenstil des aktuellen Textbereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getParagraphStyle()

Gibt den ParagraphStyle des aktuellen Textbereichs zurück.

Rückflug

ParagraphStyle: Der Absatzstil des aktuellen Textbereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getParagraphs()

Gibt die Absätze zurück, die sich mit dem aktuellen Textbereich überschneiden.

Rückflug

Paragraph[]: Eine Liste mit Absätzen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getRange(startOffset, endOffset)

Gibt einen neuen TextRange zurück, der einen Teil des Bereichs abdeckt, aus dem er abgeleitet wird.

Parameter

NameTypBeschreibung
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des zurückgegebenen Bereichs zu bestimmen. Der Start-Offset muss größer oder gleich 0 und kleiner oder gleich endOffset sein. startOffset muss auch kleiner als die Länge des aktuellen Bereichs sein.
endOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die zum Bestimmen des exklusiven Endindex des zurückgegebenen Bereichs verwendet werden. endOffset muss gleich oder größer als startOffset sein. endOffset muss auch kleiner oder gleich der Länge des aktuellen Bereichs sein.

Rückflug

TextRange: Ein neuer Textbereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getRuns()

Gibt die Textläufe zurück, die sich mit dem aktuellen Textbereich überschneiden. Ein Textlauf ist ein Textsegment, in dem alle Zeichen denselben Textstil haben.

Jeder zurückgegebene Bereich umfasst garantiert nur einen Lauf, wenn er erstellt wird. Durch Text- oder Stiländerungen kann es passieren, dass die Darstellung nicht mehr genau einem Lauf entspricht.

Rückflug

TextRange[] – Eine Liste von Textbereichen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getStartIndex()

Gibt den 0-basierten Index für das erste Zeichen in diesem Bereich zurück (einschließlich). Wenn der Start- und der Endindex gleich sind, gilt der Bereich als leer.

Rückflug

Integer: Der Startindex des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTextStyle()

Gibt die Textformatierung des Bereichs zurück oder null, wenn der Bereich leer ist.

Rückflug

TextStyle|null: Der Textstil des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertParagraph(startOffset, text)

Fügt einen Absatz am Start-Offset ein. Der Absatz behält die Formatierung des aktuellen Textbereichs an der Startabweichung bei.

Der angegebene Textstring wird als Absatz eingefügt, indem dem String mindestens ein umgebendes Zeilenumbruchzeichen hinzugefügt wird.

Wenn der angegebene Textstring Zeilenumbruchzeichen enthält und somit aus mehreren Absätzen besteht, wird der zuletzt hinzugefügte Absatz zurückgegeben.

Parameter

NameTypBeschreibung
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des einzufügenden Texts zu bestimmen.
textStringDer einzufügende String.

Rückflug

Paragraph: Die eingefügte Paragraph.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertRange(startOffset, textRange)

Fügt eine Kopie des angegebenen Textbereichs am Start-Offset ein.

Die Formatierung des eingefügten Texts entspricht der des Quelltexts.

Parameter

NameTypBeschreibung
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des einzufügenden Texts zu bestimmen.
textRangeTextRangeDer einzufügende Textbereich.

Rückflug

TextRange: Der Textbereich, der den eingefügten Text darstellt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertRange(startOffset, textRange, matchSourceFormatting)

Fügt eine Kopie des angegebenen Textbereichs am Start-Offset ein.

Wenn diese Option so festgelegt ist, dass sie mit der Formatierung des Zieltexts übereinstimmt, werden AutoText im angegebenen Textbereich durch die gerenderten Werte ersetzt. Außerdem werden alle Nicht-Textelemente im angegebenen Textbereich nicht eingefügt.

Parameter

NameTypBeschreibung
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des einzufügenden Texts zu bestimmen.
textRangeTextRangeDer einzufügende Textbereich.
matchSourceFormattingBooleanBei true wird die Formatierung des Quelltexts übernommen, bei false die Formatierung des Zieltexts.

Rückflug

TextRange: Der Textbereich, der den eingefügten Text darstellt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertText(startOffset, text)

Fügt Text am Start-Offset ein. Der Text behält die Formatierung des vorhandenen Texts am Start-Offset bei.

Parameter

NameTypBeschreibung
startOffsetIntegerDie Anzahl der Zeichen nach dem Startindex des aktuellen Textbereichs, die verwendet werden, um den inklusiven Startindex des einzufügenden Texts zu bestimmen.
textStringDer einzufügende String.

Rückflug

TextRange: Der Textbereich, der den eingefügten Text darstellt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isEmpty()

Gibt true zurück, wenn in diesem Bereich keine Zeichen vorhanden sind, andernfalls false.

Rückflug

Boolean – true, wenn in diesem Bereich keine Zeichen vorhanden sind, andernfalls wird false zurückgegeben.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

replaceAllText(findText, replaceText)

Ersetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Parameter

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringDer Text, der den übereinstimmenden Text ersetzen soll.

Rückflug

Integer: Die Anzahl der Vorkommen hat sich geändert.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

replaceAllText(findText, replaceText, matchCase)

Ersetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“.

Parameter

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringDer Text, der den übereinstimmenden Text ersetzen soll.
matchCaseBooleanWenn true, wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Wenn false, wird die Groß-/Kleinschreibung bei der Suche nicht beachtet.

Rückflug

Integer: Die Anzahl der Vorkommen hat sich geändert.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

select()

Wählt nur das TextRange in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen.

Ein Skript kann nur auf die Auswahl des Nutzers zugreifen, der das Skript ausführt, und nur, wenn das Skript an die Präsentation gebunden ist.

Das übergeordnete Element Page des entsprechenden Shape oder des TableCell wird als current page selection festgelegt. Shape oder TableCell wird als selected page element festgelegt.

    Die Selection kann zwei Typen haben:
    • 1. Textbereich: Verwenden Sie „select“ für einen nicht leeren TextRange, um den Bereich der Zeichen auszuwählen.
    • 2. Cursorposition: Verwenden Sie einen leeren TextRange, um den Cursor am gewünschten Index zu platzieren. 
      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();

      Autorisierung

      Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

    setText(newText)

    Legt den Text fest, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird. Der Text behält die Formatierung des Anfangs des vorhandenen Texts bei.

    Parameter

    NameTypBeschreibung
    newTextStringDer String, der als neuer Text festgelegt werden soll.

    Rückflug

    TextRange: Der Textbereich, der den festgelegten Text darstellt.

    Autorisierung

    Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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