Skip to main content

Метод Search.findText

Метод выполняет поиск строки с учетом и без учета регистра:

  • во всем документе;
  • в выбранном диапазоне;
  • в выбранном диапазоне ячеек;
  • в таблице.

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

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

warning

Библиотеки Document API по умолчанию работают с документами используя английскую локализацию. Поэтому, при взаимодействии с документом через API, значения могут отличаться от отображаемых в интерфейсе редактора. Раздел Локализация документов содержит информацию о том, как работать с локализованными значениями.

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


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

Параметры​

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

Пример​


 # Поиск по всему документу
 search = myOfficeSDK.createSearch(document)
 searchResult = search.findText("Yellow", myOfficeSDK.CaseSensitive_Yes)
 // Отображение результатов поиска
 for searchRange in searchResult:
  print(searchRange.extractText())

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