ТабличныйДокумент.НайтиТекст (SpreadsheetDocument.FindText)
ТабличныйДокумент (SpreadsheetDocument)
НайтиТекст (FindText)
Доступен, начиная с версии 8.1.
Синтаксис:
НайтиТекст(<Строка>, <Начало>, <Где>, <ИскатьПоСтрокам>, <ЯчейкаЦеликом>, <ИскатьВперед>, <ИгнорироватьРегистр>)Параметры:
<Строка> (обязательный)
Искомый текст.
<Начало> (необязательный)
Область, после которой начинать поиск. Если параметр не указан, поиск будет выполнен с начала табличного документа.
<Где> (необязательный)
Область, в которой осуществляется поиск. Если параметр не указан, поиск будет выполнен по всем ячейкам табличного документа.
<ИскатьПоСтрокам> (необязательный)
Определяет последовательность обхода ячеек при поиске.
Истина - искать по текущей строке, затем переходить на следующую и т.д. в общем направлении поиска, Ложь - искать по текущей колонке, затем переходить на следующую и т.д. в общем направлении поиска.
Значение по умолчанию: Истина.
<ЯчейкаЦеликом> (необязательный)
Истина - искать только такие ячейки, в которых с искомым текстом совпадает весь текст ячейки, Ложь - искать часть текста ячейки.
Значение по умолчанию: Ложь.
<ИскатьВперед> (необязательный)
Определяет направление поиска: Истина - искать вперед; Ложь - искать назад.
Значение по умолчанию: Истина.
<ИгнорироватьРегистр> (необязательный)
Истина - без учета регистра, Ложь - с учетом регистра.
Значение по умолчанию: Ложь.
Возвращаемое значение:
Тип: ОбластьЯчеекТабличногоДокумента, РисунокТабличногоДокумента.Область, содержащая искомый текст. Если текст не найден, то возвращается значение Неопределено.
Описание:
Осуществляет поиск текста в ячейках табличного документа.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
| // чтобы посмотреть работу данного метода, добавьте // следующие строки в конец примера метода НачатьГруппуСтрок() Отдел = "Итого2"; Область=ТабДок.НайтиТекст(Отдел); Если ТипЗнч(Область)=Тип("Неопределено") Тогда Сообщить("Значение не найдено!"); Иначе Поз = Найти(Область.Имя,"C"); Имя= Лев(Область.Имя,Поз)+ Строка(Число(Прав(Область.Имя,СтрДлина(Область.Имя)-Поз))+1); Сообщить("Итог по отделу 2 = "+ТабДок.Область(Имя).Текст); КонецЕсли; |
Использование в версии:
Доступен, начиная с версии 8.1.
Описание изменено в версии 8.3.23.