Class TextRange

Текстдиапазон

Сегмент текстового содержимого 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 Шаблон регулярного выражения для поиска; любые обратные косые черты в шаблоне должны быть экранированы.

Возвращаться

TextRange[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

find(pattern, startOffset)

Возвращает все диапазоны, соответствующие шаблону поиска в текущем текстовом диапазоне, начиная с начального смещения. Поиск чувствителен к регистру.

Параметры

Имя Тип Описание
pattern String Шаблон регулярного выражения для поиска; любые обратные косые черты в шаблоне должны быть экранированы.
startOffset Integer Число символов после начального индекса текущего текстового диапазона, используемое для определения включающего начального индекса диапазона для поиска. startOffset также должен быть меньше длины текущего диапазона.

Возвращаться

TextRange[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getAutoTexts()

Возвращает автоматические тексты в текущем текстовом диапазоне.

Возвращаться

AutoText[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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

Возвращает коллекцию текстовых диапазонов, которые соответствуют всем 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

Возвращаться

TextRange[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getListParagraphs()

Возвращает абзацы в списках, перекрывающие текущий текстовый диапазон.

Возвращаться

Paragraph[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getListStyle()

Возвращает ListStyle текущего текстового диапазона.

Возвращаться

ListStyle

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getParagraphStyle()

Возвращает ParagraphStyle текущего текстового диапазона.

Возвращаться

ParagraphStyle

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getParagraphs()

Возвращает абзацы, перекрывающие текущий текстовый диапазон.

Возвращаться

Paragraph[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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 также должен быть меньше или равен длине текущего диапазона.

Возвращаться

TextRange

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getRuns()

Возвращает фрагменты текста, перекрывающие текущий текстовый диапазон. Текстовый фрагмент — это сегмент текста, в котором все символы имеют одинаковый текстовый стиль.

Каждый возвращаемый диапазон гарантированно охватывает только один запуск при его создании. Изменения текста или стиля могут привести к тому, что он больше не будет представлять собой ровно один запуск.

Возвращаться

TextRange[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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 , если диапазон пуст.

Возвращаться

TextStyle

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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