2. Если в данный момент загружен другой учитель, то выполняется запрос inDelete. Учитель считывается из файла или из памяти.
3. Если считывание завершается по ошибке, то возникает ошибка 602 — ошибка считывания учителя, управление передается обработчику ошибок, а обработка запроса прекращается.
Удаление учителя (inDelete)
Описание запроса:
Pascal:
Function inDelete: Logic;
C:
Logic inDelete()
Аргументов нет.
Назначение — удаляет загруженного в память учителя.
Описание исполнения.
1. Если список в момент получения запроса учитель не загружен, то возникает ошибка 601 — неверное имя учителя, управление передается обработчику ошибок, а обработка запроса прекращается.
Запись компонента (inWrite)
Описание запроса:
Pascal:
Function inWrite(Var FileName: PString): Logic;
C:
Logic inWrite(PString* FileName)
Описание аргументов:
CompName — указатель на строку символов, содержащую имя компонента.
FileName — имя файла или адрес памяти, куда надо записать компонент.
Назначение — сохраняет учителя в файле или в памяти.
Описание исполнения.
1. Если в момент получения запроса учитель не загружен, то возникает ошибка 601 — неверное имя компонента, управление передается обработчику ошибок, а обработка запроса прекращается.
2. Если в качестве аргумента FileName дана строка, первые четыре символа которой составляют слово File, то остальная часть строки содержит имя файла для записи компонента. В противном случае FileName должен содержать пустой указатель. В этом случае запрос вернет в нем указатель на область памяти, куда будет помещено описание компонента в формате для записи на диск. Если описание не вмещается в одну область памяти, то в текст будет включено ключевое слово Continue, за которым следует четыре байта, содержащие адрес следующей области памяти.
3. Если во время сохранения компонента возникнет ошибка, то возникает ошибка 603 — ошибка сохранения компонента, управление передается обработчику ошибок, а обработка запроса прекращается.
Инициация редактора учителя
К этой группе запросов относится запрос, который инициирует работу не рассматриваемого в данной работе компонента — редактора учителя.
Редактировать компонент (inEdit)
Описание запроса:
Pascal:
Procedure inEdit(CompName: PString);
C:
void inEdit(PString CompName)
Описание аргумента:
CompName — указатель на строку символов — имя файла или адрес памяти, содержащие описание учителя.
Если в качестве аргумента CompName дана строка, первые четыре символа которой составляют слово File, то остальная часть строки содержит имя учителя и после пробела имя файла, содержащего описание учителя. В противном случае считается, что аргумент CompName содержит указатель на область памяти, содержащую описание учителя в формате для записи на диск. Если описание не вмещается в одну область памяти, то допускается включение в текст описания ключевого слова Continue, за которым следует четыре байта, содержащие адрес следующей области памяти.
Если в качестве аргумента CompName передан пустой указатель или указатель на пустую строку, то редактор создает нового учителя.
Работа с параметрами учителя
В данном разделе описаны запросы, позволяющие изменять параметры учителя.
Получить параметры (ingetdata)
Описание запроса:
Pascal:
Function inGetData(Var Param: PRealArray): Logic;
C:
Logic inGetData(PRealArray* Param)
Описание аргумента:
Param — адрес массива параметров.
Назначение — возвращает вектор параметров учителя.
Описание исполнения.
1. Если Error <> 0, то выполнение запроса прекращается.
2. Если в момент получения запроса учитель не загружен, то возникает ошибка 601 — неверное имя компонента, управление передается обработчику ошибок, а обработка запроса прекращается.
3. В массив, адрес которого передан в аргументе Param, заносятся значения параметров. Параметры заносятся в массив в порядке описания в разделе описания статических переменных.
Получить имена параметров (inGetName)
Описание запроса:
Pascal:
Function inGetName(Var Param: PRealArray): Logic;
C:
Logic inGetName(PRealArray* Param)
Описание аргумента:
Param — адрес массива указателей на названия параметров.
Назначение — возвращает вектор указателей на названия параметров учителя.
Описание исполнения.
1. Если Error <> 0, то выполнение запроса прекращается.
2. Если в момент получения запроса учитель не загружен, то возникает ошибка 601 — неверное имя компонента, управление передается обработчику ошибок, а обработка запроса прекращается.
Читать дальше