Table.FindByValue

FindByValue (Поиск по значению)
Объект: Электронная таблица Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в число, строку, неверные параметры Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Электронная таблица

Функция производит поиск строки или части строки в значениях ячеек указанной области таблицы (или во всей таблице), руководствуясь заданными правилами. Если ячейка найдена, функция возвращает ее координату в виде строки "<Столбец>:<Строка>" (пример "12:100") и перемещает курсор в найденную ячейку, если это необходимо, если ячейка не найдена, функция возвращает пустую строку.

Синтаксис

Table.FindByValue(<Значение для поиска>,<Установки поиска (INT)>=0,<Область поиска (STRING)>,<Переместить курсор на найденную ячейку (INT)>=0):<Найденная ячейка (STRING)>

Аргументы

• <Значение для поиска> - Задает значение, поиск которого осуществляется в таблице
• <Установки поиска (INT)> - (необязательный аргумент) Задает параметра поиска. Битовая маска, доступны следующие биты:
  • бит 0: 0 -- Производить поиск по столбцам, затем по строкам, 1 -- Производить поиск по строкам, затем по столбцам.
• <Область поиска (STRING)> - (необязательный аргумент) Задает область поиска в виде [<Начальный столбец области>],[<Начальная строка области>]:[<Конечный столбец области>],[<Конечная строка области>], любую из цифр можно опустить. Если аргумент опущен, поиск будет осуществляться по всем заданным ячейкам таблицы.
• <Переместить курсор на найденную ячейку (INT)> - (необязательный аргумент) Если значение будет найдено, курсор будет автоматически перемещен в найденную ячейку, иначе (по умолчанию) положение курсора не изменится.

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

Возвращает строку с координатой найденной ячейки или пустую строку, если ячейка не найдена.

Примеры

//Док -- документ для поиска
Таб:=Form.Таблица.Value;
Таб.FindByValue(Док,0,,1);