Приложения
Приложение А. Функции, константы и структуры RDS
А.2. События блока и связанные с ними описания
А.2.5. События загрузки и сохранения схемы и отдельных блоков
А.2.5.4. RDS_BFM_LOADBIN – загрузка данных блока в двоичном формате
Поток, в котором вызывается функция модели
Главный поток RDS.
Первый параметр функции модели (int CallMode)
Константа RDS_BFM_LOADBIN.
Третий параметр функции модели (void *ExtParam)
Не используется (NULL).
Возвращаемое функцией модели значение
| RDS_BFR_DONE | Данные загружены успешно. |
| RDS_BFR_ERROR | При загрузке произошла ошибка. |
Примечания
Реакция на событие RDS_BFM_LOADBIN вызывается для загрузки данных, сохраненных моделью в двоичном формате при сохранении схемы или отдельного блока в момент реакции на событие RDS_BFM_SAVEBIN. Модель должна загрузить в память параметры блока, хранящиеся в его личной области данных, не обрабатываемой RDS, причем размеры и последовательность загружаемых блоков данных должны совпадать с размерами и последовательностью сохраненных.
Загрузка данных блока выполняется в следующих случаях:
- при загрузке блока в составе схемы;
- при загрузке отдельного блока из файла на диске (например, при вставке его в схему из библиотеки блоков);
- при вставке блока из буфера обмена.
Событие RDS_BFM_LOADBIN возникает только в том случае, если данные блока были сохранены в двоичном формате. Если данные были сохранены в текстовом, вместо него возникнет событие RDS_BFM_LOADTXT. Формат сохранения может выбираться моделью блока независимо от того, в каком формате сохраняется вся схема или блок, поэтому в функции модели блока достаточно предусмотреть реакцию либо на пару событий, работающих с двоичным форматом (RDS_BFM_SAVEBIN/RDS_BFM_LOADBIN), либо на пару, работающую с текстовым (RDS_BFM_SAVETXT/RDS_BFM_LOADTXT). Сохранение и загрузка данных блока подробно рассматриваются в §2.8 руководства программиста.
См. также