Skip to main content

Метод Position:getNextRange

Метод возвращает диапазон, который расположен после текущего диапазона. Размеры текущего и следующего диапазонов зависят от выбранной единицы текста. Если выбранная единица текста отлична от Paragraph, то работа метода Position:getNextRange ограничена текущим абзацем.

Вызов​


Range getNextRange(textUnit)

Параметры​

  • textUnit: единица текста, определяющая размеры диапазонов, тип TextUnit.

Возвращает​

  • следующий диапазон документа, тип Range.

Пример для текстового документа​


local docBegin = document:getRange():getBegin()
local nextSentence = docBegin:getNextRange(DocumentAPI.TextUnit_Sentence)
local nextWord = docBegin:getNextRange(DocumentAPI.TextUnit_Word):getBegin():getNextRange(DocumentAPI.TextUnit_Word)
local nextCharacter = docBegin:getNextRange(DocumentAPI.TextUnit_Character)

print(nextSentence:extractText())
-- Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
print(nextWord:extractText()) -- ipsum
print(nextCharacter:extractText()) -- o

Пример для табличного документа​


local sheet = document:getBlocks():getTable(0)
local cell = sheet:getCell("B2")
local cellBegin = cell:getRange():getBegin()
local sentence = cellBegin:getNextRange(DocumentAPI.TextUnit_Sentence)

print(sentence:extractText()) -- Second sentence.