Оглавление | Родительский раздел

ТабличныйДокумент.НайтиТекст (SpreadsheetDocument.FindText)

ТабличныйДокумент (SpreadsheetDocument)
НайтиТекст (FindText)

Синтаксис:

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

Параметры:

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

Тип: Строка.
Искомый текст.

<Начало> (необязательный)

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

<Где> (необязательный)

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

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

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

<ЯчейкаЦеликом> (необязательный)

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

<ИскатьВперед> (необязательный)

Тип: Булево.
Определяет направление поиска: Истина - искать вперед; Ложь - искать назад.
Значение по умолчанию: Истина.

<ИгнорироватьРегистр> (необязательный)

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

Возвращаемое значение:

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

Описание:

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

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

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

Пример:

// чтобы посмотреть работу данного метода, добавьте 

// следующие строки в конец примера метода НачатьГруппуСтрок()

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