Table.FindByValue
Revision as of 16:51, 26 July 2020 by Admin (talk | contribs) (Created page with "{{infobox function |name=FindByValue |object=Электронная таблица |caption=Поиск по значению |typ...")
FindByValue (Поиск по значению) | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Функция производит поиск строки или части строки в значениях ячеек указанной области таблицы (или во всей таблице), руководствуясь заданными правилами. Если ячейка найдена, функция возвращает ее координату в виде строки "<Столбец>:<Строка>"
(пример "12:100") и перемещает курсор в найденную ячейку, если это необходимо, если ячейка не найдена, функция возвращает пустую строку.
Синтаксис
Table.FindByValue(<Значение для поиска>,<Установки поиска (INT)>=0,<Область поиска (STRING)>,<Переместить курсор на найденную ячейку (INT)>=0):<Найденная ячейка (STRING)>
Аргументы
<Значение для поиска>
- Задает значение, поиск которого осуществляется в таблице<Установки поиска (INT)>
- (необязательный аргумент) Задает параметра поиска. Битовая маска, доступны следующие биты:- бит 0: 0 -- Производить поиск по столбцам, затем по строкам, 1 -- Производить поиск по строкам, затем по столбцам.
<Область поиска (STRING)>
- (необязательный аргумент) Задает область поиска в виде[<Начальный столбец области>],[<Начальная строка области>]:[<Конечный столбец области>],[<Конечная строка области>]
, любую из цифр можно опустить. Если аргумент опущен, поиск будет осуществляться по всем заданным ячейкам таблицы.<Переместить курсор на найденную ячейку (INT)>
- (необязательный аргумент) Если значение будет найдено, курсор будет автоматически перемещен в найденную ячейку, иначе (по умолчанию) положение курсора не изменится.
Возвращаемое значение
Возвращает строку с координатой найденной ячейки или пустую строку, если ячейка не найдена.
Примеры
//Док -- документ для поиска Таб:=Form.Таблица.Value; Таб.FindByValue(Док,0,,1);