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