НайтиТекст

[1cwiki]

Раздел

Общие объекты

Подразделы

Табличный документ

ТипСтатьи

Методы

Синтаксис:

НайтиТекст(<Строка>, <Начало>, <Где>, <ИскатьПоСтрокам>, <ЯчейкаЦеликом>, <ИскатьВперед>, <ИгнорироватьРегистр>)
Параметры:

<Строка> (обязательный)

Тип: Строка.
Искомый текст.
<Начало> (необязательный)

Тип: ОбластьЯчеекТабличногоДокумента.
Область, после которой начинать поиск. Если параметр не указан, поиск будет выполнен с начала табличного документа.
<Где> (необязательный)

Тип: ОбластьЯчеекТабличногоДокумента.
Область, в которой осуществляется поиск. Если параметр не указан, поиск будет выполнен по всем ячейкам табличного документа.
<ИскатьПоСтрокам> (необязательный)

Тип: Булево.
Определяет последовательность обхода ячеек при поиске.
Истина - искать по текущей строке, затем переходить на следующую и т.д. в общем направлении поиска, Ложь - искать по текущей колонке, затем переходить на следующую и т.д. в общем направлении поиска.
Значение по умолчанию: Истина.
<ЯчейкаЦеликом> (необязательный)

Тип: Булево.
Истина - искать только такие ячейки, в которых с искомым текстом совпадает весь текст ячейки, Ложь - искать часть текста ячейки.
Значение по умолчанию: Ложь.
<ИскатьВперед> (необязательный)

Тип: Булево.
Определяет направление поиска: Истина - искать вперед; Ложь - искать назад.
Значение по умолчанию: Истина.
<ИгнорироватьРегистр> (необязательный)

Тип: Булево.
Истина - без учета регистра, Ложь - поиск с учетом регистра.
Значение по умолчанию: Ложь.
Возвращаемое значение:

Тип: ОбластьЯчеекТабличногоДокумента; РисунокТабличногоДокумента.
Область, содержащая искомый текст. Если текст не найден, то возвращается значение Неопределено.
Описание:

Осуществляет поиск текста в ячейках табличного документа.

Доступность:

Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение(клиент), мобильное приложение(сервер).
Пример:

Код Выделить Развернуть

// чтобы посмотреть работу данного метода, добавьте
// следующие строки в конец примера метода НачатьГруппуСтрок()
Отдел = "Итого2";
Область=ТабДок.НайтиТекст(Отдел);
Если ТипЗнч(Область)=Тип("Неопределено") Тогда
    Сообщить("Значение не найдено!");
Иначе
    Поз = Найти(Область.Имя,"C");
    Имя= Лев(Область.Имя,Поз)+
        Строка(Число(Прав(Область.Имя,СтрДлина(Область.Имя)-Поз))+1);
    Сообщить("Итог по отделу 2 = "+ТабДок.Область(Имя).Текст);
КонецЕсли;