Метод GetFirstIn (Integer, Byte) : Integer
Top  Previous  Next


Назначение  
Найти первую запись в узле iNum логической таблицы. Если iNum=-1, то навигация производится по корневой таблице.  
Описание  
function GetFirstIn (iNum : Integer; Flags : Byte) : Integer;  
Параметры  
iNum : Integer - номер узла логической таблицы, по которому производится навигация. Если iNum=-1, то навигация производится по корневой таблице.  
Flags : Byte - флаги навигации. Флаги не оказывают влияния на результат работы данной функции, они влияют только на последующие вызовы функций GetNextIn и GetPrevIn: если в дальнейшем предполагается производить навигацию только по узлу iNum без учета подцепленных таблиц, то параметер Flags должен быть равен 0; если же в дальнейшем навигация будет производиться по подцепленной таблице, то параметр Flags должен быть равен 1. Например, есть список счетов, и для каждого счета есть список спецификаций. Если требуется перебрать все счета, не просматривая спецификации, то нужно вызывать описываемую функцию с параметром Flags=0. Если же требуется перебор счетов и всех спецификаций, то Flags=1.  
Возвращаемое значение  
Функция возвращает 0, если требуемая запись найдена. В противном случае возвращается код ошибки.  
Смотрите также  
GetLastIn, GetPrevIn, GetNextIn  
Пример  
Данный пример иллюстрирует использование параметра Flags. Предполагается, что текущая подцепка таблиц определяет следующую структуру данных:  
Таблица счетов (iNum=0)  
Счет1   
Счет2   
…   
 
Таблица спецификаций (iNum=1)  
Спецификация 1 счета 1   
Спецификация 2 счета 1   
Спецификация 3 счета 1   
Спецификация 4 счета 1   
Спецификация 1 счета 2   
Спецификация 2 счета 2   
Спецификация 3 счета 2   
Спецификация 4 счета 2   
Спецификация 5 счета 2   
…   
Если Flags=0, то:  
· GetFirstIn(0,0) - будет найден счет1 и какая-то спецификация счета 1;  
· GetNextIn(0,0) - будет найден счет2 и какая-то спецификация счета 2.  
Если Flags=1, то  
· GetFirstIn(0,1) - будет найден счет1 и спецификация 1 счета 1;  
· GetNextIn(0,1) - будет найден счет1 и спецификация 2 счета 1;  
µ Если в функциях GetFirstIn и GetNextIn используются разные значения параметра Flags, то результат выполнения функции становится непредсказуемым.  
· GetFirstIn(0,0) - будет найден счет1 и спецификация 1 счета 1;  
· GetNextIn(1,1) - результат не определен. Какая-то запись может найтись, а может и не найтись.