Skip to main content

Метод Search:findText

Метод выполняет поиск строки без учета регистра во всем документе или выбранном диапазоне документа. Результат возвращается в виде диапазона DocumentAPI.Range, содержащего искомый фрагмент.

Если строка не обнаружена, возвращается пустая таблица.

Возможно использование следующих вариантов метода:


Range findText(String text)
Range findText(String text, CaseSensitive caseSensitive)
Range findText(String text, Range range)
Range findText(String text, Range range, CaseSensitive caseSensitive)
Range findText(String text, CellRange cellRange)
Range findText(String text, CellRange cellRange, CaseSensitive caseSensitive)
Range findText(String text, Table tbl)
Range findText(String text, Table tbl, CaseSensitive caseSensitive)

Параметры​

  • text – строка для поиска;
  • caseSensitive – поиск с учетом или без учета регистра, тип DocumentAPI.CaseSensitive;
  • range – диапазон, в котором будет производиться поиск, тип DocumentAPI.Range;
  • cellRange – диапазон ячеек, в котором будет производиться поиск, тип DocumentAPI.CellRange;
  • table – таблица, в которой будет производиться поиск, тип DocumentAPI.Table.

Пример​


search = DocumentAPI.createSearch(document)
-- Поиск по всему документу
ranges = search:findText("English")
for occurrence in ranges do
print(occurrence:extractText())
end

Дополнительные примеры использования метода Search:findText приведены в разделе Поиск в документе.