Функция LoadVipInterface

Назначение

Функция LoadVipInterface предназначена для загрузки индивидуального экземпляра VIP-интерфейса. Интерфейсу передаются инициализирующие события cmOnVipLoad и cmOnVipUse.

Функция LoadVipInterface всегда создает новую загруженную копию интерфейса.

Аргументом обязательно должна быть переменная типа ссылки на vipInterface. Если это условие нарушено, то будет возбуждено исключение ExObjIfcBadVar.

Описание

function LoadVipInterface (var ref : VarOfInterFaceType
						) : boolean;

Параметры

ref - переменная типа ссылки на VIP-интерфейс. В результате исполнения функции ссылка получает значение ссылки на загруженную копию интерфейса.

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

Функция возвращает true, если VIP-интерфейс успешно загружен, иначе false. Если переменная была инициализирована до вызова функции, то происходит освобождение занятой ссылки.

В результате выполнения функции ссылка получает значение ссылки на загруженную копию VIP-интерфейса.

Если в загружаемом интерфейсе в обработчике cmOnVipLoad выполнился Abort, функция возвращает false. При этом не возникает никаких исключений, а переменной присваивается NullRef.

Исключения:

• ExObjIfcBadVar - переменная не является ссылкой на VIP-интерфейс.

• ExObjIfcNoLoad - невозможно загрузить интерфейс.

Пример

Загружается интерфейс interf1:

........
var
  a : interf1;
...........
LoadVipInterface (a);

Версия

Начиная с Атлантис 5.0.02.