Метод Locate – найти запись
Contents
Синтаксис:
function Locate( KeyNames: OleVariant; KeyValues: OleVariant): WordBool; |
Параметры:
| • | KeyNames – массив имен реквизитов или имя одного реквизита; |
| • | KeyValues – массив значений реквизитов или значение одного реквизита, имена которых указаны в параметре KeyNames. |
Возвращаемое значение:
Результат поиска: True, если запись была найдена, иначе False.
Описание:
Метод ищет запись в наборе данных. Если запись найдена, то она становится текущей в наборе данных.
Если запись не найдена, то текущей останется прежняя запись.
Если вызвать метод у объекта IDataSet, который является наследником объекта IQuery, то:
| • | если в момент вызова у текущей записи есть несохраненные изменения, будет сгенерировано исключение; |
| • | если в момент вызова текущая запись была открыта, то выполняются обработчики событий «Карточка. Закрытие», «Карточка. Открытие»; |
| • | после вызова обновляются данные в элементах управления, связанных с реквизитами набора данных. |
Пример:
Component.Locate('Analit'; '23454')
Component.Locate(ArrayOf('DatOpen'; 'DatClose');
ArrayOf('01.01.2016'; '01.01.2017'))
Свойство IDataSet.Events |
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |