Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.2. События блока и связанные с ними описания

А.2.5. События загрузки и сохранения схемы и отдельных блоков

А.2.5.7. RDS_BFM_SAVETXT – запись данных блока в текстовом формате

# Приложения

## Приложение А. Функции, константы и структуры 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.