Diese Seite wurde von der Cloud Translation API übersetzt.

Class TextRange

Segment des Textinhalts eines Shape- oder TableCell-Elements.

Wenn Sie Methoden verwenden, mit denen die Anpassung des Textes in eine Form bearbeitet wird, werden alle Einstellungen für die automatische Anpassung werden die Formen deaktiviert.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`appendParagraph(text)`	`Paragraph`	Hängt am Ende des Textbereichs einen Absatz an.
`appendRange(textRange)`	`TextRange`	Hängt eine Kopie des angegebenen Textbereichs an das Ende des aktuellen Textbereichs an.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Hängt eine Kopie des angegebenen Textbereichs an das Ende des aktuellen Textbereichs an.
`appendText(text)`	`TextRange`	Fügt am Ende des Textbereichs Text an.
`asRenderedString()`	`String`	Gibt den gerenderten Text zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle in einem Format, das den Endnutzern angezeigt wird.
`asString()`	`String`	Gibt den Rohtext zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt ist.
`clear()`	`void`	Löscht den durch diesen Bereich begrenzten Text.
`clear(startOffset, endOffset)`	`void`	Löscht den Text, der durch die Start- und End-Offsets im Bereich begrenzt ist.
`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 entsprechen, beginnend beim Startversatz.
`getAutoTexts()`	`AutoText[]`	Gibt die automatischen Texte innerhalb des aktuellen Textbereichs zurück.
`getEndIndex()`	`Integer`	Gibt den exklusiven, 0-basierten Index für das letzte Zeichen in diesem Bereich zurück.
`getLength()`	`Integer`	Gibt die Anzahl der Zeichen in diesem Bereich zurück.
`getLinks()`	`TextRange[]`	Gibt eine Sammlung von Textbereichen zurück, die allen `Link`s im aktuellen oder den aktuellen Textbereich überlappen.
`getListParagraphs()`	`Paragraph[]`	Gibt die Absätze in Listen zurück, die den aktuellen Textbereich überlappen.
`getListStyle()`	`ListStyle`	Gibt die `ListStyle` des aktuellen Textbereichs zurück.
`getParagraphStyle()`	`ParagraphStyle`	Gibt die `ParagraphStyle` des aktuellen Textbereichs zurück.
`getParagraphs()`	`Paragraph[]`	Gibt die Absätze zurück, die den aktuellen Textbereich überlappen.
`getRange(startOffset, endOffset)`	`TextRange`	Gibt eine neue `TextRange` zurück, die einen Teil des Bereichs abdeckt, aus dem sie abgeleitet wurde.
`getRuns()`	`TextRange[]`	Gibt die Textausführungen zurück, die den aktuellen Textbereich überlappen.
`getStartIndex()`	`Integer`	Gibt den einschließenden, 0-basierten Index für das erste Zeichen in diesem Bereich zurück.
`getTextStyle()`	`TextStyle`	Gibt den Textstil des Bereichs oder `null` zurück, wenn der Bereich leer ist.
`insertParagraph(startOffset, text)`	`Paragraph`	Fügt am Anfangsversatz einen Absatz ein.
`insertRange(startOffset, textRange)`	`TextRange`	Fügt eine Kopie des angegebenen Textbereichs am Startversatz ein.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Fügt eine Kopie des angegebenen Textbereichs am Startversatz ein.
`insertText(startOffset, text)`	`TextRange`	Fügt Text am Anfangsversatz ein.
`isEmpty()`	`Boolean`	Gibt `true` zurück, wenn sich in diesem Bereich keine Zeichen befinden, und gibt `false` zurück sonst.
`replaceAllText(findText, replaceText)`	`Integer`	Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".
`select()`	`void`	Wählt nur das `TextRange` in der aktiven Präsentation aus und entfernt alle vorherigen Auswahl.
`setText(newText)`	`TextRange`	Legt den Text fest, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt wird.

Detaillierte Dokumentation

`appendParagraph(text)`

Hängt am Ende des Textbereichs einen Absatz an. Der Absatz behält den Stil des Ende des aktuellen Textbereichs.

Die angegebene Textzeichenfolge wird als Absatz angehängt, indem mindestens ein umgebender String hinzugefügt wird Zeilenvorschubzeichen hinzu.

Wenn die angegebene Textzeichenfolge Zeilenumbruchzeichen enthält (also aus mehreren Absätze) wird der zuletzt hinzugefügte Absatz zurückgegeben.

Parameter

Name	Typ	Beschreibung
`text`	`String`	Zeichenfolge, die als Absatz angehängt werden soll.

Rückflug

Paragraph: das angehängte Paragraph.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`appendRange(textRange)`

Hängt eine Kopie des angegebenen Textbereichs an das Ende des aktuellen Textbereichs an.

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

Parameter

Name	Typ	Beschreibung
`textRange`	`TextRange`	Der Textbereich, der angefügt werden soll.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`appendRange(textRange, matchSourceFormatting)`

Hängt eine Kopie des angegebenen Textbereichs an das Ende des aktuellen Textbereichs an.

Wenn festgelegt, dass sie der Formatierung des Zieltexts entspricht, AutoText innerhalb der angegebenen Textbereich durch ihre gerenderten Werte ersetzt. Darüber hinaus können alle Nicht-Text-Elemente in angegebener Textbereich nicht angehängt werden.

Parameter

Name	Typ	Beschreibung
`textRange`	`TextRange`	Der Textbereich, der angefügt werden soll.
`matchSourceFormatting`	`Boolean`	Bei `true` wird die Formatierung des Ausgangstexts verwendet. wenn `false`, entspricht der Formatierung des Zieltexts.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`appendText(text)`

Fügt am Ende des Textbereichs Text an. Der Text behält den Stil des Endes des vorhandener Text.

Parameter

Name	Typ	Beschreibung
`text`	`String`	Die Zeichenfolge, die angehängt werden soll.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 in einem Format, das den Endnutzern angezeigt wird.

AutoText-Elemente wie generierte Foliennummern werden durch ihre gerenderten Werte ersetzt. Alle Nicht-Text-Elemente im Bereich werden weggelassen.

Rückflug

String

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`asString()`

Gibt den Rohtext zurück, der durch diesen Bereich der zugehörigen Form oder Tabellenzelle begrenzt ist.

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

Rückflug

String

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clear()`

Löscht den durch diesen Bereich begrenzten Text.

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`clear(startOffset, endOffset)`

Löscht den Text, der durch die Start- und End-Offsets im Bereich begrenzt ist.

Da der Text mit einem Zeilenumbruch enden muss, wird der letzte Zeilenvorschub durch die angegebenen Offsets abgedeckt sind.

Parameter

Name	Typ	Beschreibung
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs um den Index für den einschließenden Start des zu löschenden Bereichs zu bestimmen. Der Startversatz muss gleich oder größer als 0 und kleiner oder gleich `endOffset` ist. `startOffset` muss außerdem kleiner als die Länge des aktuellen Bereichs sein.
`endOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs um den exklusiven Endindex des zu löschenden Bereichs zu bestimmen. Der `endOffset` muss gleich oder größer als `startOffset` ist. `endOffset` muss auch kleiner als oder sein. gleich der Länge des aktuellen Bereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 Die Suchanfrage ist Groß-/Kleinschreibung beachten.

Parameter

Name	Typ	Beschreibung
`pattern`	`String`	Muster des regulären Ausdrucks, nach dem gesucht werden soll sollten umgekehrte Schrägstriche im Muster in Escape-Zeichen gesetzt werden.

Rückflug

TextRange[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 entsprechen, beginnend beim Startversatz. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

Name	Typ	Beschreibung
`pattern`	`String`	Muster des regulären Ausdrucks, nach dem gesucht werden soll sollten umgekehrte Schrägstriche im Muster in Escape-Zeichen gesetzt werden.
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs , um den inklusiven Startindex des zu durchsuchenden Bereichs zu bestimmen. `startOffset` muss kleiner als die Länge des aktuellen Bereichs sein.

Rückflug

TextRange[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getAutoTexts()`

Gibt die automatischen Texte innerhalb des aktuellen Textbereichs zurück.

Rückflug

AutoText[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getEndIndex()`

Gibt den exklusiven, 0-basierten Index für das letzte Zeichen in diesem Bereich zurück. Wenn Start und Ende gleich sind, wird der Bereich als leer angesehen.

Rückflug

Integer

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getLinks()`

Gibt eine Sammlung von Textbereichen zurück, die allen Links im aktuellen oder den aktuellen Textbereich überlappen.

Jeder zurückgegebene Bereich umfasst bei seiner Erstellung garantiert einen Link. Textänderungen können dazu führen, dass sie nicht mehr genau einen Link repräsentiert.

Jede Link der zurückgegebenen Bereiche kann über TextStyle.getLink() aufgerufen werden.

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

Rückflug

TextRange[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getListParagraphs()`

Gibt die Absätze in Listen zurück, die den aktuellen Textbereich überlappen.

Rückflug

Paragraph[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getListStyle()`

Gibt die ListStyle des aktuellen Textbereichs zurück.

Rückflug

ListStyle

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getParagraphStyle()`

Gibt die ParagraphStyle des aktuellen Textbereichs zurück.

Rückflug

ParagraphStyle

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getParagraphs()`

Gibt die Absätze zurück, die den aktuellen Textbereich überlappen.

Rückflug

Paragraph[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getRange(startOffset, endOffset)`

Gibt eine neue TextRange zurück, die einen Teil des Bereichs abdeckt, aus dem sie abgeleitet wurde.

Parameter

Name	Typ	Beschreibung
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs , um den inklusiven Startindex des zurückgegebenen Bereichs zu bestimmen. Der Startversatz muss gleich oder größer als 0 und kleiner oder gleich `endOffset` ist. `startOffset` muss außerdem kleiner als die Länge des aktuellen Bereichs sein.
`endOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs um den exklusiven Endindex des zurückgegebenen Bereichs zu bestimmen. Der `endOffset` muss gleich oder größer als `startOffset` ist. `endOffset` muss auch kleiner als oder sein. gleich der Länge des aktuellen Bereichs.

Rückflug

TextRange

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getRuns()`

Gibt die Textausführungen zurück, die den aktuellen Textbereich überlappen. Ein Textlauf ist ein Textsegment, wobei alle Zeichen den gleichen Textstil haben.

Jeder zurückgegebene Bereich umfasst bei seiner Erstellung immer nur eine Ausführung. Text oder Stil können Änderungen dazu führen, dass sie nicht mehr genau eine Ausführung repräsentieren.

Rückflug

TextRange[]

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getStartIndex()`

Gibt den einschließenden, 0-basierten Index für das erste Zeichen in diesem Bereich zurück. Wenn die Anfangs- und Endindexe gleich sind, wird der Bereich als leer angesehen.

Rückflug

Integer

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getTextStyle()`

Gibt den Textstil des Bereichs oder null zurück, wenn der Bereich leer ist.

Rückflug

TextStyle

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`insertParagraph(startOffset, text)`

Fügt am Anfangsversatz einen Absatz ein. Der Absatz behält den Stil des aktuellen Textbereich beim Startversatz.

Die angegebene Textzeichenfolge wird als Absatz eingefügt, indem mindestens ein umgebender String hinzugefügt wird Zeilenvorschubzeichen hinzu.

Wenn die angegebene Textzeichenfolge Zeilenumbruchzeichen enthält (also aus mehreren Absätze) wird der zuletzt hinzugefügte Absatz zurückgegeben.

Parameter

Name	Typ	Beschreibung
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs , um den einschließenden Startindex des einzufügenden Textes zu bestimmen.
`text`	`String`	Die einzufügende Zeichenfolge.

Rückflug

Paragraph: die eingefügte Paragraph.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`insertRange(startOffset, textRange)`

Fügt eine Kopie des angegebenen Textbereichs am Startversatz ein.

Die Formatierung des eingefügten Textes entspricht der Formatierung des Ausgangstexts.

Parameter

Name	Typ	Beschreibung
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs , um den einschließenden Startindex des einzufügenden Textes zu bestimmen.
`textRange`	`TextRange`	Der einzufügende Textbereich.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 Startversatz ein.

Parameter

Name	Typ	Beschreibung
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs , um den einschließenden Startindex des einzufügenden Textes zu bestimmen.
`textRange`	`TextRange`	Der einzufügende Textbereich.
`matchSourceFormatting`	`Boolean`	Bei `true` wird die Formatierung des Ausgangstexts verwendet. wenn `false`, entspricht der Formatierung des Zieltexts.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`insertText(startOffset, text)`

Fügt Text am Anfangsversatz ein. Der Stil des vorhandenen Textes wird beim Startversatz.

Parameter

Name	Typ	Beschreibung
`startOffset`	`Integer`	Die Anzahl der Zeichen nach dem Startindex des aktuell verwendeten Textbereichs , um den einschließenden Startindex des einzufügenden Textes zu bestimmen.
`text`	`String`	Die einzufügende Zeichenfolge.

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`isEmpty()`

Gibt true zurück, wenn sich in diesem Bereich keine Zeichen befinden, und gibt false zurück sonst.

Rückflug

Boolean

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`replaceAllText(findText, replaceText)`

Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen". Bei der Suche handelt es sich um die Groß-/Kleinschreibung. unsensibel.

Parameter

Name	Typ	Beschreibung
`findText`	`String`	Der zu suchende Text.
`replaceText`	`String`	Der Text, durch den der übereinstimmende Text ersetzt werden soll.

Rückflug

Integer – Anzahl der geänderten Vorkommnisse

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`replaceAllText(findText, replaceText, matchCase)`

Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".

Parameter

Name	Typ	Beschreibung
`findText`	`String`	Der zu suchende Text.
`replaceText`	`String`	Der Text, durch den der übereinstimmende Text ersetzt werden soll.
`matchCase`	`Boolean`	Wenn `true`, wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Wenn `false`, lautet die Suche Groß- und Kleinschreibung nicht berücksichtigt werden.

Rückflug

Integer – Anzahl der geänderten Vorkommnisse

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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 Auswahl.

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

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

Es gibt zwei Arten von Selection: <ph type="x-smartling-placeholder">

1. Textbereich; verwenden Sie „select“ für einen nicht leeren TextRange, um den Bereich des Zeichen.
2. Cursorposition: Verwenden Sie ein leeres TextRange-Element, um den Cursor am gewünschten Index zu platzieren.
```
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();
```
Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
- 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 den Stil des Anfangs des vorhandenen Textes.

Parameter

Name	Typ	Beschreibung
`newText`	`String`	Die Zeichenfolge, die als neuer Text festgelegt werden soll.

Rückflug

TextRange: der Textbereich, der den festgelegten Text darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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