Skip to main content

Метод Search.findText

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

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

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

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

Внимание

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

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


 RangesEnumerator findText(string text, CaseSensitive caseSensitive)
 RangesEnumerator findText(string text)
 RangesEnumerator findText(string text, Range range, CaseSensitive caseSensitive)
 RangesEnumerator findText(string text, Range range)
 RangesEnumerator findText(string text, CellRange cellRange, CaseSensitive caseSensitive)
 RangesEnumerator findText(string text, CellRange cellRange)
 RangesEnumerator findText(string text, Table table, CaseSensitive caseSensitive)
 RangesEnumerator findText(string text, Table table)

Параметры​

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

Пример​


 // Поиск по всему документу, отображение результатов поиска
 Search search = DocumentAPI.createSearch(document);
 RangesEnumerator searchResult = search.findText("API", CaseSensitive.Yes);
 while (searchResult.MoveNext())
 {
    var range = searchResult.Current;
    Console.WriteLine(range.extractText());
 }

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