Сегмент текстового содержимого Shape
или TableCell
.
Если вы используете методы, редактирующие размещение текста в фигуре, все параметры автоподбора, примененные к фигуре, деактивируются.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
appendParagraph(text) | Paragraph | Добавляет абзац в конец текстового диапазона. |
appendRange(textRange) | TextRange | Добавляет копию предоставленного текстового диапазона в конец текущего текстового диапазона. |
appendRange(textRange, matchSourceFormatting) | TextRange | Добавляет копию предоставленного текстового диапазона в конец текущего текстового диапазона. |
appendText(text) | TextRange | Добавляет текст в конец текстового диапазона. |
asRenderedString() | String | Возвращает отображаемый текст, ограниченный этим диапазоном связанной фигуры или ячейки таблицы, в формате, подходящем для отображения конечным пользователям. |
asString() | String | Возвращает необработанный текст, ограниченный этим диапазоном связанной фигуры или ячейки таблицы. |
clear() | void | Очищает текст, ограниченный этим диапазоном. |
clear(startOffset, endOffset) | void | Очищает текст, ограниченный начальным и конечным смещением диапазона. |
find(pattern) | TextRange[] | Возвращает все диапазоны, соответствующие шаблону поиска в текущем текстовом диапазоне. |
find(pattern, startOffset) | TextRange[] | Возвращает все диапазоны, соответствующие шаблону поиска в текущем текстовом диапазоне, начиная с начального смещения. |
getAutoTexts() | AutoText[] | Возвращает автоматические тексты в текущем текстовом диапазоне. |
getEndIndex() | Integer | Возвращает исключительный индекс, отсчитываемый от 0, для последнего символа в этом диапазоне. |
getLength() | Integer | Возвращает количество символов в этом диапазоне. |
getLinks() | TextRange[] | Возвращает коллекцию текстовых диапазонов, которые соответствуют всем Link в текущем текстовом диапазоне или перекрывают текущий текстовый диапазон. |
getListParagraphs() | Paragraph[] | Возвращает абзацы в списках, перекрывающие текущий текстовый диапазон. |
getListStyle() | ListStyle | Возвращает ListStyle текущего текстового диапазона. |
getParagraphStyle() | ParagraphStyle | Возвращает ParagraphStyle текущего текстового диапазона. |
getParagraphs() | Paragraph[] | Возвращает абзацы, перекрывающие текущий текстовый диапазон. |
getRange(startOffset, endOffset) | TextRange | Возвращает новый TextRange , охватывающий часть диапазона, из которого он получен. |
getRuns() | TextRange[] | Возвращает фрагменты текста, перекрывающие текущий текстовый диапазон. |
getStartIndex() | Integer | Возвращает инклюзивный индекс, отсчитываемый от 0, для первого символа в этом диапазоне. |
getTextStyle() | TextStyle | Возвращает стиль текста диапазона или null , если диапазон пуст. |
insertParagraph(startOffset, text) | Paragraph | Вставляет абзац со смещением в начале. |
insertRange(startOffset, textRange) | TextRange | Вставляет копию предоставленного текстового диапазона по начальному смещению. |
insertRange(startOffset, textRange, matchSourceFormatting) | TextRange | Вставляет копию предоставленного текстового диапазона по начальному смещению. |
insertText(startOffset, text) | TextRange | Вставляет текст со смещением начала. |
isEmpty() | Boolean | Возвращает true если в этом диапазоне нет символов, и возвращает false в противном случае. |
replaceAllText(findText, replaceText) | Integer | Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены. |
replaceAllText(findText, replaceText, matchCase) | Integer | Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены. |
select() | void | Выбирает только TextRange в активной презентации и удаляет любой предыдущий выбор. |
setText(newText) | TextRange | Устанавливает текст, ограниченный этим диапазоном связанной фигуры или ячейки таблицы. |
Подробная документация
appendParagraph(text)
Добавляет абзац в конец текстового диапазона. Абзац сохраняет стиль конца текущего текстового диапазона.
Предоставленная текстовая строка добавляется как абзац путем добавления к строке хотя бы одного окружающего символа новой строки.
Если предоставленная текстовая строка содержит символы новой строки (таким образом, состоящую из нескольких абзацев), возвращается последний добавленный абзац.
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Строка, добавляемая в качестве абзаца. |
Возвращаться
Paragraph
— добавленный Paragraph
.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange)
Добавляет копию предоставленного текстового диапазона в конец текущего текстового диапазона.
Форматирование вставленного текста будет соответствовать форматированию исходного текста.
Параметры
Имя | Тип | Описание |
---|---|---|
textRange | TextRange | Текстовый диапазон для добавления. |
Возвращаться
TextRange
— текстовый диапазон, представляющий добавленный текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange, matchSourceFormatting)
Добавляет копию предоставленного текстового диапазона в конец текущего текстового диапазона.
Если установлено соответствие форматированию целевого текста, AutoText
в предоставленном текстовом диапазоне заменяется визуализированными значениями. Более того, любые нетекстовые элементы в пределах предоставленного текстового диапазона не добавляются.
Параметры
Имя | Тип | Описание |
---|---|---|
textRange | TextRange | Текстовый диапазон для добавления. |
matchSourceFormatting | Boolean | Если true , соответствует форматированию исходного текста; если false , соответствует форматированию текста назначения. |
Возвращаться
TextRange
— текстовый диапазон, представляющий добавленный текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendText(text)
Добавляет текст в конец текстового диапазона. Текст сохраняет стиль конца существующего текста.
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Строка для добавления. |
Возвращаться
TextRange
— текстовый диапазон, представляющий добавляемый текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asRenderedString()
Возвращает отображаемый текст, ограниченный этим диапазоном связанной фигуры или ячейки таблицы, в формате, подходящем для отображения конечным пользователям.
Элементы автотекста, такие как сгенерированные номера слайдов, заменяются их визуализированными значениями. Любые нетекстовые элементы в диапазоне опускаются.
Возвращаться
String
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asString()
Возвращает необработанный текст, ограниченный этим диапазоном связанной фигуры или ячейки таблицы.
Элементы автотекста, такие как сгенерированные номера слайдов и любые нетекстовые элементы в диапазоне, заменяются символом Юникода U+E907.
Возвращаться
String
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
clear()
Очищает текст, ограниченный этим диапазоном.
Поскольку весь текст в Shape или TableCell должен заканчиваться новой строкой, последняя новая строка в тексте не удаляется.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
clear(startOffset, endOffset)
Очищает текст, ограниченный начальным и конечным смещением диапазона.
Поскольку текст должен заканчиваться новой строкой, последняя новая строка в тексте не удаляется, даже если она покрыта заданными смещениями.
Параметры
Имя | Тип | Описание |
---|---|---|
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса очищаемого диапазона. Начальное смещение должно быть равно или больше 0 и меньше или равно endOffset . startOffset также должен быть меньше длины текущего диапазона. |
endOffset | Integer | Количество символов после начального индекса текущего текстового диапазона, используемого для определения эксклюзивного конечного индекса очищаемого диапазона. endOffset должен быть равен или больше startOffset . endOffset также должен быть меньше или равен длине текущего диапазона. |
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern)
Возвращает все диапазоны, соответствующие шаблону поиска в текущем текстовом диапазоне. Поиск чувствителен к регистру.
Параметры
Имя | Тип | Описание |
---|---|---|
pattern | String | Шаблон регулярного выражения для поиска; любые обратные косые черты в шаблоне должны быть экранированы. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern, startOffset)
Возвращает все диапазоны, соответствующие шаблону поиска в текущем текстовом диапазоне, начиная с начального смещения. Поиск чувствителен к регистру.
Параметры
Имя | Тип | Описание |
---|---|---|
pattern | String | Шаблон регулярного выражения для поиска; любые обратные косые черты в шаблоне должны быть экранированы. |
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса диапазона для поиска. startOffset также должен быть меньше длины текущего диапазона. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutoTexts()
Возвращает автоматические тексты в текущем текстовом диапазоне.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndIndex()
Возвращает исключительный индекс, отсчитываемый от 0, для последнего символа в этом диапазоне. Если начальный и конечный индексы равны, диапазон считается пустым.
Возвращаться
Integer
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLength()
Возвращает количество символов в этом диапазоне.
Возвращаться
Integer
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLinks()
Возвращает коллекцию текстовых диапазонов, которые соответствуют всем Link
в текущем текстовом диапазоне или перекрывают текущий текстовый диапазон.
Каждый возвращаемый диапазон гарантированно охватывает одну ссылку при его создании. Изменения текста могут привести к тому, что он больше не будет представлять ровно одну ссылку.
Доступ к каждой Link
в возвращаемых диапазонах можно получить через 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
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListParagraphs()
Возвращает абзацы в списках, перекрывающие текущий текстовый диапазон.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListStyle()
getParagraphStyle()
Возвращает ParagraphStyle
текущего текстового диапазона.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParagraphs()
Возвращает абзацы, перекрывающие текущий текстовый диапазон.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRange(startOffset, endOffset)
Возвращает новый TextRange
, охватывающий часть диапазона, из которого он получен.
Параметры
Имя | Тип | Описание |
---|---|---|
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса возвращаемого диапазона. Начальное смещение должно быть равно или больше 0 и меньше или равно endOffset . startOffset также должен быть меньше длины текущего диапазона. |
endOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения эксклюзивного конечного индекса возвращаемого диапазона. endOffset должен быть равен или больше startOffset . endOffset также должен быть меньше или равен длине текущего диапазона. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRuns()
Возвращает фрагменты текста, перекрывающие текущий текстовый диапазон. Текстовый фрагмент — это сегмент текста, в котором все символы имеют одинаковый текстовый стиль.
Каждый возвращаемый диапазон гарантированно охватывает только один запуск при его создании. Изменения текста или стиля могут привести к тому, что он больше не будет представлять собой ровно один запуск.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartIndex()
Возвращает инклюзивный индекс, отсчитываемый от 0, для первого символа в этом диапазоне. Если начальный и конечный индексы равны, диапазон считается пустым.
Возвращаться
Integer
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTextStyle()
Возвращает стиль текста диапазона или null
, если диапазон пуст.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertParagraph(startOffset, text)
Вставляет абзац со смещением в начале. В абзаце сохраняется стиль текущего текстового диапазона по начальному смещению.
Предоставленная текстовая строка вставляется как абзац путем добавления к строке хотя бы одного окружающего символа новой строки.
Если предоставленная текстовая строка содержит символы новой строки (таким образом, состоящую из нескольких абзацев), возвращается последний добавленный абзац.
Параметры
Имя | Тип | Описание |
---|---|---|
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса вставляемого текста. |
text | String | Строка для вставки. |
Возвращаться
Paragraph
— вставленный Paragraph
.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange)
Вставляет копию предоставленного текстового диапазона по начальному смещению.
Форматирование вставленного текста будет соответствовать форматированию исходного текста.
Параметры
Имя | Тип | Описание |
---|---|---|
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса вставляемого текста. |
textRange | TextRange | Текстовый диапазон для вставки. |
Возвращаться
TextRange
— текстовый диапазон, представляющий вставленный текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange, matchSourceFormatting)
Вставляет копию предоставленного текстового диапазона по начальному смещению.
Если установлено соответствие форматированию целевого текста, AutoText
в предоставленном текстовом диапазоне заменяется визуализированными значениями. Кроме того, любые нетекстовые элементы в пределах предоставленного текстового диапазона не вставляются.
Параметры
Имя | Тип | Описание |
---|---|---|
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса вставляемого текста. |
textRange | TextRange | Текстовый диапазон для вставки. |
matchSourceFormatting | Boolean | Если true , соответствует форматированию исходного текста; если false , соответствует форматированию текста назначения. |
Возвращаться
TextRange
— текстовый диапазон, представляющий вставленный текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertText(startOffset, text)
Вставляет текст со смещением начала. Текст сохраняет стиль существующего текста по начальному смещению.
Параметры
Имя | Тип | Описание |
---|---|---|
startOffset | Integer | Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса вставляемого текста. |
text | String | Строка для вставки. |
Возвращаться
TextRange
— текстовый диапазон, представляющий вставленный текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isEmpty()
Возвращает true
если в этом диапазоне нет символов, и возвращает false
в противном случае.
Возвращаться
Boolean
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены. Поиск нечувствителен к регистру.
Параметры
Имя | Тип | Описание |
---|---|---|
findText | String | Текст, который нужно найти. |
replaceText | String | Текст для замены совпавшего текста. |
Возвращаться
Integer
— количество измененных вхождений
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены.
Параметры
Имя | Тип | Описание |
---|---|---|
findText | String | Текст, который нужно найти. |
replaceText | String | Текст для замены совпавшего текста. |
matchCase | Boolean | Если true , поиск чувствителен к регистру; если false , поиск нечувствителен к регистру. |
Возвращаться
Integer
— количество измененных вхождений
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Выбирает только TextRange
в активной презентации и удаляет любой предыдущий выбор.
Сценарий может получить доступ только к выбору пользователя, запускающего сценарий, и только в том случае, если сценарий привязан к презентации.
Родительская Page
соответствующей Shape
или TableCell
устанавливается в качестве current page selection
. Shape
или TableCell
устанавливается в качестве selected page element
.
Selection
может быть двух типов:- 1. Диапазон текста. Используйте select для непустого TextRange, чтобы выбрать диапазон символов.
- 2. Позиция курсора. Используйте пустой TextRange, чтобы поместить курсор в нужный индекс.
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();
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
-
setText(newText)
Устанавливает текст, ограниченный этим диапазоном связанной фигуры или ячейки таблицы. Текст сохраняет стиль начала существующего текста.
Параметры
Имя | Тип | Описание |
---|---|---|
newText | String | Строка, которая будет установлена в качестве нового текста. |
Возвращаться
TextRange
— текстовый диапазон, представляющий заданный текст.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations